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TO  THE  READER 


The  PDP-11  Keypad  Editor  is  a  text  file  editor  that  DIGITAL  has  designed 
for  use  with  VTIOO  terminals  that  have  special  function  keypads.  A  version  of 
the  keypad  editor  also  can  be  used  with  VT52  and  VT55  terminals.  The 
keypad  editor  is  suitable  as  the  first  text  editor  for  a  new  user  of  the  RT-U 
V4,  RSX-llM  V3.2,  RSX-llM-PLUS,  or  IAS  V3.1  operating  systems. 

This  preface  describes: 

•  The  relationship  between  this  manual  and  the  other  keypad  editor  docu- 
mentation. 

•  The  skills  that  you  should  have  before  beginning  to  study  this  manual. 

•  The  contents  of  this  manual  and  the  other  documentation  for  the  keypad 
editor. 

•  The  symbols  and  conventions  used  in  this  manual  and  in  the  other  docu- 
ments for  the  keypad  editor. 

Keypad  Editor  Documentation 

The  keypad  editor  documentation  is  composed  of  three  items: 

•  This  manual,  the  PDP-11  Keypad  Editor  User's  Guide. 

•  The  PDP-11  Keypad  Editor  Reference  Card. 

•  Special  summaries  called  HELP  forms  that  you  can  display  on  your  screen 
while  you  are  using  the  keypad  editor. 

This  manual  is  the  principal  document  for  the  keypad  editor.  It  presents  the 
keypad  editor  features  in  logically  related  groups,  such  as  features  for 
searching,  for  inserting,  and  for  erasing. 

The  descriptions  of  the  individual  features  are  organized  so  that  approxi- 
mately the  same  technical  level  of  detail  appears  at  the  same  point  in  each 
description.  For  example,  the  description  of  each  keypad  function  has  the 
following  five  parts: 

•  Heading  —  The  heading  shows  the  function  name  and  lists  the  VTIOO  and 
VT52  keys  that  control  the  function. 

•  Purpose  and  effect  of  the  function. 

•  Example-  of  what  the  function  does. 

•  Special  details. 

•  Summary  of  situations  when  the  function  is  invalid. 
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The  PDP-11  Keypad  Editor  Reference  Card  contains  a  brief  description  of  all 
keypad  editor  features. 

The  HELP  forms  include  diagrams  of  the  VTIOO  and  VT52  keypads  and 
summaries  of  the  keypad  editor  commands  and  functions.  The  diagrams  show 
the  keypad  editor  features  controlled  by  each  keypad  key.  The  summaries 
show  the  forms  of  the  commands  and  the  features  controlled  by  each  keyboard 
key. 

Prerequisites 

For  RT-11  V4  Users  — 

Have  the  keypad  editor  program  copied  to  your  system  volume  or  to 
another  volume  that  you  want  to  use.  Complete  Chapters  1  -  4  in  the 
Introduction  to  RT-11.  Study  Chapter  4  in  the  RT-11  User's  Guide,  and 
learn  to  use  the  interactive  commands  DIR,  EDIT,  R,  and  RUN. 

For  RSX-llM  V3.2  Users  — 

Check  that  the  keypad  editor  programs  have  been  installed.  Complete 
the  RSX-llM  Beginner's  Guide  and  the  sections  of  the  Introduction  to 
RSX-llM  that  cover  file  specifications  and  default  storage  volumes. 

For  RSX-llM-PLUS  Users  — 

Check  that  the  keypad  editor  programs  have  been  installed.  Complete 
the  Introduction  to  RSX-llM-PLUS.  Study  the  RSX-llM/M-PLUS 
MCR  Operations  Manual,  and  learn  to  start  and  stop  the  Monitor  Con- 
sole Routine  (MCR). 

For  IAS  V3.1  Users  — 

Your  IAS  system  already  contains  keypad  editor  programs  for  use  with 
the  DCL  or  MCR  command  language  interfaces.  If  your  installation  uses 
DCL,  read  Chapters  1-6  of  the  IAS  PDS  User's  Guide.  Read  Chapter  14 
for  details  of  PDS  commands.  If  your  installation  uses  MCR,  read  Chap- 
ters 1,  2,  3,  and  6  of  the  IAS  MCR  User's  Guide. 

Chapter  Summary 

Chapter  1  discusses  the  general  concepts  of  text  file  editing  and  summarizes 
how  the  keypad  editor  processes  input  files  and  stores  output  files.  Chapter  1 
also  offers  suggestions  about  how  you  can  learn  to  use  the  keypad  editor  and 
includes  an  example  that  demonstrates  several  of  the  keypad  editor  features. 

Chapter  2  describes  how  to  start  and  stop  the  editor  on  each  oi  the  supported 
operating  systems.  This  chapter  tells  how  to  use  the  keypad  editor  to  inspect, 
create,  and  ndit  text  files.  The  common  sequences  of  operating  system  com- 
mands and  keypad  editor  command  lines  are  illustrated. 

Chapter  3  describes  the  functions  that  are  active  when  you  are  only  inspecting 
(not  creating  or  changing)  a  text  file.  This  chapter  covers  functions  that 
display  different  parts  of  a  file  and  search  for  strings  of  characters.  The 
chapter  also  covers  other  functions  that  are  essential  when  you  are  making 
changes  to  a  text  file. 
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Chapter  4  describes  the  functions  that  are  active  when  you  are  creating  or 
changing  a  text  file.  This  chapter  covers  the  functions  that  insert,  erase, 
substitute,  and  move  text. 

Chapter  5  describes  several  supplementary  features.  This  chapter  covers  the 
uses  of  auxiliary  files,  sequences  of  keypad  editor  functions  (called  "macros"), 
and  features  for  formatting  text  files,  indenting  hig.  -level  language  source 
programs,  and  reordering  MACRO- 11  local  symbols. 

The  Appendix  lists  the  keypad  editor  messages  in  alphabetical  order.  An 
explanation  of  the  causes  and  a  description  of  the  remedies  follows  each 
message. 

Symbols  and  Conventions 

This  manual  and  the  PDP-11  Keypad  Editor  Reference  Card  use  the  fol- 
lowing symbols  and  conventions.  Although  most  of  them  are  the  same  as  the 
symbols  and  conventions  used  in  other  documents  for  PDP-11  software,  the 
VTIOO  terminal  and  the  video  orientation  of  the  keypad  editor  require  a  few 
changes. 


System  prompts 


Red  print 


Uppercase  letters 
(In  commands) 


Lowercase  letters 
(In  commands) 


Indicate  that  the  system  is  ready  for  you  to  enter  a  com- 
mand. The  system  prompts  are: 

For  RT-11:  a  period  (.) 

For  RSX-llM:  the  characters  MCR>  or  a  right-angle 

bracket  (>)  by  itself. 

For    RSX-llM-PLUS:    the    dollar    sign    (*)    or    the 

RSX-llM  prompts  (when  the  MCR  is  running). 

For  IAS:  the  characters  PDS>orMCR>. 

Indicates  the  characters  typed  on  the  keyboard  in  exam- 
ples of  commands.  Black  print  in  these  examples  indi- 
cates the  characters  displayed  by  the  system  or  by  the 
keypad  editor. 

Indicate  the  characters  that  you  must  type  on  the  key- 
board (see  "Lowercase  letters"  also). 

Indicate  the  parts  of  commands  or  umand  strings 
that  you  must  supply  (see  "Uppercase  letters"  also). 


Underlined  letters 
(In  general  forms 
of  commands) 


Indicate  the  shortest  valid  abbreviation  of  a  keypad  ed- 
itor command. 


CmD 


Indicates  a  combination  of  the  control  key  and  another 
keyboard  key.  For  example,  for  tTRi/u)  hold  down  the 
CTRL  key  and  press  the  U  key. 


XI 
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Square  brackets 
(In  general  forms 
of  commands) 

Braces 


(  ) 


Dot  matrix  letters 


F'.nclose  an  optional  term  or  optional  characters  '■  ..ot 
type  square  brackets  as  part  of  a  command  unless  the 
instructions  explicitly  require  them). 

Enclose  a  list  of  two  or  more  terms  from  which  you  must 
choose  and  type  one  (do  not  type  braces  as  part  of  a 
command). 

Enclose  a  keypad  editor  function  name  or  name  of  a 
labeled  key. 

Indicate  prompts,  short  status  messages,  and  keypad  ed- 
itor commands. 


xu 


Chapter  1 
Introduction 


The  PDP-11  Keypad  Editor  is  a  program  that  you  can  use  to  create  and 
change  computer  files  that  DKtlTAL  calls  text  files.  Text  files  contain  only 
the  untranslated  letters,  digits,  and  symbols  that  you  can  type  on  your  key- 
board. You  cannot  use  the  keypad  editor  to  change  other  types  of  computer 
files,  such  as  binary  files,  relative  files,  indexed  files,  or  object  files,  because 
they  contain  special  translated  characters  that  the  keypad  editor  program 
cannot  read. 


1.1    What  Are  Text  Files  For? 


A  text  file  can  be  used  for  various  purposes,  such  as: 

•  For  a  memo  or  a  collection  of  memos. 

•  F'or  a  computer  program  or  the  data  a  computer  program  requires. 

•  For  a  table  of  values,  arranged  in  columns  and  rows,  to  attach  to  a  report. 

•  For  a  list  of  names  and  addresses. 

•  For  a  chapter  of  a  book  or  an  entire  book. 

Regardless  of  the  purpose  of  a  text  file,  the  keypad  editor  has  features  for  you 
to  use  when  you  want  to  create  or  edit  a  file.  The  general  procedure  for  editing 
a  text  file  is  as  follows: 

1.  vStart  the  keypad  editor  p/ogram.  Chapter  2  describes  the  commands  to 
use  for  each  operating  system  that  supports  the  Keypad  editor. 

2.  Specify  the  file  that  you  want  to  edit  (the  main  input  file)  and  the  new 
version  of  the  file  that  will  include  your  changes  (the  main  output  file). 
Chapter  2  describes  how  to  type  these  file  specifications. 

3.  Use  the  keypad  editor's  functions  and  commands  to  display  different  parts 
of  the  file  and  to  make  changes.  Chapters  3  and  4  describe  the  simplest 
and  most  frequently  used  features,  and  Chapter  5  describes  special  fea- 
tures that  you  may  also  want  to  use. 
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4.  Use  the  keypad  editor  EXIT  command  to  close  the  output  file  and  have 
your  system  store  it. 

5.  Continue  editing  by  typing  other  file  specifications  as  in  Step  2.  Or  stop 
the  keypad  editor  by  using  the  appropriate  procedure  for  your  operating 
system.  Chapter  2  describes  the  requirements. 


1.2    What  Are  KED  and  K52? 

DIGITAL  distributes  two  versions  of  the  PDP-11  Keypad  Editor,  KED  is  the 
version  for  use  with  the  VTIOO  family  of  video  terminals.  K52  is  the  version  for 
use  with  VT52  and  VT55  video  terminals. 

KED  and  K52  provide  the  same  basic  features.  Any  editing  that  you  can  do 
with  KED  you  can  also  do  with  K52.  The  keypad  editor  versions  are  different 
only  because  of  the  different  hardware  features  that  VTlOOs  and  VT52s  have. 

In  this  manual  and  in  the  PDP-11  Keypad  Editor  Reference  Card,  the  term 
VTIOO  refers  to  all  of  DIGITAL'S  video  terminals  that  are  compatible  with  the 
VTIOO  terminal,  and  the  term  VT52  refers  to  VT52s  and  VT55s. 

The  following  list  summarizes  the  general  differences  between  KED  and  K52. 

1.  Keyboards  and  keypads 

Because  the  VTIOO  and  VT52  terminals  have  different  keyboards  and 
keypads,  KED  and  Kr)2  in  a  small  number  of  cases  use  different  keys  to 
control  the  editing  functions. 

2.  Special  graphic  symbols 

Because  the  terminals  have  different  sets  of  special  graphic  symbols,  KED 
and  K52  display  files  in  slightly  different  ways. 

3.  Video  features 

Because  the  VTIOO  has  several  video  features  that  the  VT52  does  not 
have,  such  as  reverse  video  display  and  132-column  screen  width,  KED 
provides  six  more  commands  than  K52.  These  commands  allow  you  to 
adjust  VTIOO  features  while  you  are  editing. 


1.3    What  Does  the  Keypad  Editor  Do? 

The  keypad  editor  allows  you  to  create,  inspect,  and  edit  files.  In  doing  so,  it 
manipulates  the  files  that  you  have  specified,  processes  the  characters  that 
your  terminal  sends  when  you  type  the  keyboard  and  keypad  keys,  and  con- 
trols the  screen  display  on  your  terminal.  For  example,  the  keypad  editor: 

1.  Opens  and  closes  the  files  that  you  specify. 

2.  Inserts  the  letters,  numbers,  and  symbols  that  you  type  on  the  keyboard. 

3.  Executes  the  commands  that  you  enter. 
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4.  F^rocesses  the  editing  functions  that  you  specify  by  typing  the  keypad 
keys. 

5.  Immediately  displays  the  effect  of  each  function  or  command  as  you  use 
it. 


1.3.1    The  Difference  Between  Functions  and  Commands 

While  you  are  using  the  keypad  editor,  you  control  the  different  editing  pro- 
cesses by  using  a  set  of  functions  and  a  set  of  commands.  This  manual  and  the 
PDP-ll  Keypad  Editor  Reference  Card  use  the  following  definitions  of  the 
terms  function  and  command: 

1 .  A  function  is  a  process  that  you  control  by  typing  one  or  two  keystrokes  on 
the  VTIOO  and  VT52  keypad  keys,  the  \T100  arrow  keys,  or  ten  of  the 
keyboard  keys. 

Figures  1-1  and  1-2  are  keypad  diagrams  that  show  the  functions  that 
each  keypad  key  controls.  The  most  common  functions  that  are  con- 
trolled by  keyboard  keys  are  listed  below  each  diagram. 

2.  A  command  is  a  process  that  you  control  by  first  using  the  COMMAND 
function,  then  entering  the  command  name  in  full  or  abbreviated  on  the 
keyboard,  and  finally  using  the  ENTER  function. 

Table   1-1   lists  the  keypad  editor  commands  and  describes  each  one 
brietlv. 


Introduction        1-3 


/'           \ 

{      1 

FINDNEXT 

DELLINE 

GOLD 

HELP 

FIND 

UNDELLINE 

I            P'^J 

I            Pf^J 

I             P"J 

I         pfaJ 

PAGE 

SECTION 

APPEND 

'^DELWORD 

CO^llMAND 

FILL 

REPLACE 

UNDELWORD 

I                 J 

I            sj 

I                  9J 

V                 J 

ADVANCE 

BACKUP 

r '"'  1 

^ DELCHAR^ 

BOTTOM 

TOP 

PASTE 

UNOELCHAR 

I                 *J 

I            V 

I                   ej 

■^                   J 

WORD 

{  ''"  1 

CHAR 

f  IM  T  f  R  ^ 

CHNGCASE 

DELEOL 

SPECINS 

V               J 

L      2J 

I         y 

BLINE 

SELECT 

OPENLINE 

RESET 

SUBSTITUTE 

I                         V 

V                  > 

V                   > 

Note      The  letters,  numbers  and  characters  in  the  lower  right 

corner  of  the  keys  are  what  actually  appear  on  the  keys. 


Common  Keyboard  Functions 


DELETE 

LINEFEED 

CTRL/U 

CTRL/W 
CTRL/C 
GOLD  integer 


Erases  the  character  to  the  left  of 

the  cursor 

Erases  the  word  to  the  left  of  the 

cursor 

Erases  the  line  to  the  left  of  the 

cursor 

Repaints  the  screen 

Cancels 

Repeats     any     function     except 

DELETE  or  SPECINS 


Figure  1-1:    Keypad  Diagram  for  the  KED  Keypad  Editor 
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REPLACE 


PAGE 


^/^ 


COMMAND 


MNDNEXl 


FIND 


8 


OELWORD 

UNOELWORD 
I  9 


'advance  '\r 

BOTTOM 


BACKUP 
TOP 


^DELCHAR^ 
UNDELCHAR 


I 

SECTION 


SPEC  INS 


WORD 


\r 


CHNGCASE 
1 


DELEOL 


CUT 
PASTE 


APPEND 


BLINE 
OPENLINE 


SELECT 
RESET 


ENTER     ' 
SUBSTITUTE 


Note:    The  letters,  numbers  and  characters  in  the  lower  right 

corner  of  the  keys  are  what  actually  appear  on  the  keys. 


Common  Keyboard  Functions 


DELETE 

LINEFEED 

CTRL/U 

CTRL/W 
CTRL/C 
GOLD  integer 


Erases  the  character  to  the  left  of 

the  cursor 

Erases  the  word  to  the  left  of  the 

cursor 

Erases  the  line  to  the  left  of  the 

cursor 

Repaints  the  screen 

Cancels 

Repeats     any     function     except 

DELETE  or  SPECINS 


J 


Figure  1-2:    Keypad  Diagram  for  the  K52  Keypad  Editor 
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Table  1-1:    Summary  of  Commands  and  Keyboard  Functions 


COMMAND  or  FUNCTION 


CLEAR  PAf)TE 

CLOSE 

EXIT 

FILL 


General  editing  functions 
gfRLCj 

gTRLJj) 
gTRL^ 
gTRLz) 

LdeleteJ 

[LINEFEED^i 
rGOLD)nnn 

IXCLCDE       nnn  PACES 

nnnl  LINES] 
REST 

LEARN 

Editor  macro  functions 
i  GOLDJ  S 
fGOLDlX 

LOCAL!  start infi-valuel  increment)  1 

(OPEN  IINIHT  file-spec 
iOPEN  lOl'TPCT  file-spec 
PCRCE 
QUIT 

SET  [ENTITY  IPA(;E    Tnnnl  LINESl^ 

-<  "string"  y 

L 'string"  J 

SET  [ENTITY  ISECTION    pinnl  LINES 

"S  "string" 
L  'string' 

SET  QUIET 

SET  NOQUIE' 

SET  [SCREEN  180 
SET  (SCREEN  ]V.V2 
SET  [SCREEN  jLICHT 
SET  [SCREEN  [DARK 
SET  (SEARCH  i(iF:NERAL 


PURPOSE 


Clears  the  paste  buffer. 

Closes  the  auxiliary  output  file. 

(^loses  all  ojien  files. 

Reformats  the  select  range  to  fit  within  the 

current   right   margin  (also  available  as  a 

function  on  the  VTKM)  keypad). 

Cancels  the  command  or  function  that  is 

being  processed. 

Erases  one  line  to  the  left. 

Repaints  the  screen. 

Cancels  editor  prompts. 

Erases  one  character  to  the  left. 

Erases  one  word  to  the  left. 

Repeats  the  next  function  nnn  times. 

Copies  pages  (as  currently  defined)  from 

the  auxiliary  input  file. 

Copies  text  lines. 

Copies  the  remainder  of  the  file. 

Begins  recording  a  sequence  of  commands 
and  functions  as  an  editor  macro. 

Stops  recording  the  macro. 

Executes  the  macro,  as  currently  recorded. 


Renumbers  MACRO   11  local  symbols. 
Opens  an  auxilairy  input  file. 
Opens  an  auxiliary  output  file. 
Purges  the  auxiliary  output  tile. 
Purges  all  open  output  files. 

Defines  a  page  by  line  count. 

Defines  a  page  by  a  marker  string  of  one  or 

more  characters. 

Defines  a  section  by  line  count. 

Defines  a  section  by  a  marker  string  of  one 

or  more  characters. 

Sets  the  VTKH)  to  signal  with  the  reversed 
background. 

Sets  the  VTUK)  to  signal  with  the  terminal 
bell. 

Sets  the  \'Tl(K)  to  the  HO-column  width. 

Sets  the  X'TKK)  to  the  Kfli-column  width. 

Sets  the  YTKK)  to  the  light  background. 

Sets  the  X'TKK)  to  the  dark  background. 

Matches  alphabetically  regardless  of  case. 


(continued  on  next  page) 
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Table  1-1  (Cont.):    Summary  of  Commands  and  Keyboard  Functions 


I'OMMAM)  or  H  NCI  ION 

SKI    SKAI<(H    KXACI 

SF/I    SKAHCfl    HK(;iN 

SKI    >^KAH('H    K\i) 

SKI'   SKAHCH    HOI  NDKl) 

>i:i    SKAKCfl    INIiOlNDKI) 

SKI'  TABS    Mulftit; 

•>KI    .\()1AH> 

Siruilurfii  t,il)  lutu  I  inn>; 
GOLD    1-; 
GOLD     I  ) 
GOLD     A 

SK  I   W  KAI'   iin 

SKI   NOUHAI' 
SKI  I'  ffUHi  I'A(.K> 

niiii    I.INK.> 
HK>r 

TABS  A!).n  S'l';  1  •  hnnn 
WHII  K   r  ruHi  I'A(;K>' 

mill    I.I\l-'.> 
HKSI 
,>KI.K(  r 


Fl  RPOSK 


Mauhi--   iilphiiht'i  u  iills    and    rftjuirt*.   the  | 
>iiiiif  I  ii>«' 

I.fa\f>  thf  (iir>iir  at   tin-  hi->;miiirit;  "'  ''if 
lart^ft 

I,»M\  c^  ihc  curMir  at  the  cikI  nt  the  tart;ft 

I. Hint-  -far(  hiii^;  tn  a  pa^'c  a-  (■iirrcntl'.  (ic- 
Imcij 

Alli'U-  -care  hiiit:  tifsund  the  i  urrciit  [la^'t- 

iiiiahlf-  >lrui  t  un-(i  tab- 

Kiiahlf-  -tnictiircd  tali-. 

liHTcrnciit-  the  'ali  icvcl  ciMintcr 
I)fi  rtinfiit-  the  tali  U'scl-c  nuriter. 
Alit:n>  the  tab  liAcl-countcr  in  the  cur-nr 

Set-    the    ri>;ht    niarmr    and    ctialilc-   vvnrd 
\vrap 

'  )i-alilc-  \M'rd  wr.ip. 

Skip-  pa^cs  I  a-  riirrtTills   dcliiu'di  '■»  ithm 

r fic  aiixiliarv  input  tile 

Skip-  tc\t  iine- 

Skip-  t  fic  rfinamdcr  'it  the  lile. 

(  han^c  indftilaiinn. 

Write.-  t)aKes  (as  lurrentlv  d«"tme(Ii  \i>  the 

auxilirtr\  (Hitput  tile. 

Write-  text  line-. 

Write-  the  remainder  nt  the  tile 

Writes  the  seleet  ran^'e 
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1.3.2    General  Procedure  for  Using  Functions 

The  most  frequently  used  editing  process  is  insertion  ot  new  material.  There- 
fore, insertion  is  the  keypad  editor's  default  function.  To  type  an  insertion  for 
a  file  that  you  are  creating'  or  editing,  use  the  keyboard  keys  in  the  same  way 
that  you  u.se  a  typewriter.  The  standard  function  of  each  keyboard  key.  in- 
cluding the  digit  keys  in  the  top  row.  is  to  insert  the  character  that  is  printed 
on  the  key. 

All  of  the  VTIOO  keypad  keys  and  all  but  one  of  the  VTry'I  keypad  keys  control 
two  keypad  editor  functions. 

In  Figures  1-1  and  1-2.  the  function  names  that  are  printed  in  black  are  the 
standard  functions  of  the  keypad  keys.  To  use  a  standard  function,  press  the 
corresponding  key  by  itself.  P'or  example,  to  use  the  DKLWOHI)  function, 
press  the  \'T10()  keypad  key  labeled  with  a  minus  sign  ( -)  or  the  \"Vn2  keypad 
kev  labeled  9. 
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The  function  names  that  are  printed  with  a  yellow  background  are  the  alter- 
nate functions  of  the  keypad  keys.  To  use  an  alternate  function,  use  the 
C,0\A)  function  first  as  a  prefix  and  then  press  the  key  for  the  function.  For 
example,  to  use  the  TOP  function,  press  the  VTIOO  keypad  key  labeled  PFl 
and  then  the  keypad  key  labeled  5.  With  a  VY'vl.  press  the  unlabeled  blue  key 
on  the  keypad  and  then  the  keypad  key  labeled  .'). 

Five  standard  and  five  alternate  functions  are  controlled  by  keys  on  the  key- 
board. The  functions  are  described  in  Chapters  :].  4.  and  5.  To  use  them  follow 
the  same  procedure  as  for  the  keypad  functions. 


1.3.3    General  Procedure  for  Using  Commands 

A  command  is  a  i    .)cess  that  you  control  by  completing  three  steps: 

1.    Use  the  COMMAND  function  to  specify  that  you  want  to  enter  a  com- 
mand. The  editor  displays  the  following  prompt  for  commands: 

COMMAND: 


2.  Enter  the  command  name  in  full  or  abbreviated  on  the  keyboard. 

3.  I'se  the  ENTER  function  to  specify  that  your  command  is  complete. 


For  example,  to  stop  editing  a  file  and  make  the  keypad  editor  store  your  new 
versitm.  use  the  EXIT  command  as  follows: 

•  With  a  VTIOO:     (1)  Press  the  PFl  key.  then  the  7  key  on  the 

keypad. 

(2)  Enter  the  EXIT  command  by  typing  EXIT 
on  the  keyboard. 

(3)  Press  the  Pinter  key  on  the  keypad. 

•  With  a  VTfyi:       (1)  Press  the  blue  key,  then  the  7  key  on  the 

keypad. 

(2)  Enter  the  EXIT  command. 

(3)  Press  the  Enter  ke}'  on  the  keypad. 

This  manual  uses  a  concise  method  to  describe  sequences  of  commands  and 
functions.  Figure  1-3  illustrates  how  the  manual  describes  the  three-step  se- 
quence for  the  EXIT  command. 
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command]  exit  f   ENTER 


Use  the  COMMAND  function 


Enter  the  command 


J 


Use  the  ENTER  function 


Figure  1-3:    Documentation  Method  for  a  Sequence  of  Comiriands  and 
Functions 


As  Figure  1-3  illustrates,  each  function  name  is  enclosed  in  an  oval,  and  each 
command  is  printed  with  dot  matrix  letters  like  the  ones  you  see  on  your 
screen. 


1.3.4   What  You  See  on  the  Screen 

The  keypad  editor  uses  the  screen  on  your  terminal  like  a  window  to  show  you 
24  screen  lines  of  your  file*.  When  you  start  editing  a  file,  you  see  the  first  24 
screen  lines.  By  using  the  keypad  editor  functions  that  are  described  in 
Chapter  3,  you  can  make  the  editor  scroll  the  file  upward  and  downward  on 
your  screen  so  that  you  can  see  different  24-line  segments  of  the  file.  By  using 
other  functions  and  commands,  you  can  change  the  file  by  inserting  and 
erasing  material.  After  each  change,  the  editor  immediately  shows  th(  current 
file  contents  or  displays  the  message  WCRK  I NG  .  .  ,  on  your  screen  until  the 
process  is  complete. 

The  editor  always  displays  a  special  blinking  symbol  on  the  screen  called  the 
cursor.  This  manual  uses  the  symbol  i  in  examples  to  show  where  the  cursor 
is. 

The  cursor  marks  the  location  in  your  file  where  the  editor  will  insert  a 
character  if  you  type  one.  Therefore,  to  insert  new  material  in  your  file,  you 
need  only  to  use  the  editor  functions  to  advance  or  back  up  the  cursor  to  the 
location  where  you  want  the  insertion  to  appear  and  then  type  the  insertion. 

The  cursor  also  shows  where  the  editor  will  begin  processing  the  other  func- 
tions and  commands.  For  example,  to  erase  something  in  your  file,  move  the 
cursor  to  the  correct  location  and  then  use  appropriate  functions. 


'  Models  of  the  VTlOO  terminal  that  do  not  include  the  advanced  video  option  use  24  screen 
lines  when  the  line  length  is  set  to  80  characters  but  only  14  screen  lines  when  the  line  length 
is  set  to  132  characters. 
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As  you  advance  the  cursor,  the  editor  scrolls  your  file  upward,  and  as  you  back 
the  cursor  up,  the  editor  scrolls  your  file  downward.  Except  when  the  cursor's 
location  is  close  to  the  top  or  bottom  of  your  file,  the  editor  generally  keeps  the 
cursor  in  screen  line  16  so  that  you  can  see  several  lines  of  the  file  before  and 
after  the  cursor. 

The  editor  uses  other  special  symbols  to  show  where  non-printing  characters, 
such  as  the  Escape  character,  are  located.  Table  1-2  lists  the  symbols  that 
KED  and  K52  use  and  summarizes  what  each  one  stands  for.* 

Table  1-2:     Special  VTIOO  and  VT52  Symbols  Used  by  the  Keypad  Editor 


VT1 00  Symbol 

...                   , 
VT52  Symbol 

Usage 

In  prompts 

In  text 

In  prompts 

In  text 

1 

None 
None 

1 
t 

'f 

None 

S^ 

None 

1 

None 
None 

M 
M 

Nont^ 
None 

1 

None 
None 

None 
None 

i 

None 

The  cursor 

The  end  of  file  symbol 

VT  100  niiifkinij  for  chdracters 
in  d  select  ranye'* 

The  Hon/ontdl  Tdb  chatdcter 

The  VertiCdl  Tab  character 

The  Catridge  Return  character 

The  Linefeet)  character 

The  'formfeed  character 

The  Escape  character 

The  New  Lme  Termrnator 

Each  wrapped  lme 

REVERSE 

or    ^ 
None 

s 

None 

'f 

H 

None 
♦ 

''"For  models  of  the  VTlOO  terminal  without  the  advanced  video  option, 
the  keypad  editor  marks  select  ranges  as  follows: 

•  With  the  block  cursor  i,  KED  uses  reverse  video. 

•  With  the  underscore  cursor  (_),  KED  uses  underscoring. 

For  short  prompts,  the  editor  temporarily  erases  the  top  two  screen  lines  and 
displays  the  prompt  in  the  top  screen  line.  After  you  respond  to  the  prompt, 
the  editor  restores  the  two  screen  lines.  For  messages,  the  editor  uses  the  same 
process,  except  that  it  temporarily  erases  the  bottom  three  screen  lines. 

With  VTIOO  terminals.  KED  also  uses  the  VTlOO's  built-in  video  and  graphic 
features  to  clarify  some  editing  processes.  For  example.  KED  displays  mes- 
sages and  your  responses  to  prompts  with  the  reverse  video  feature. 


•  Table  1-2  shows  the  symbols  that  DIGITAL  distributed  most  recently  with  VT"V2  terminals. 
Older  VT52s  may  display  different  symbols.  Check  the  table  of  alternate  characters  in  the 
DECscope  User's  Manual  for  your  unit  if  K'vJ.  displays  different  symbols  from  those  shown 
here. 
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1.4    What  You  Can  Do  to  Your  Files 


You  can  use  the  keypad  editor  to  inspect  a  file,  create  a  new  file,  or  edit  a  file. 
This  section  tells  you  how  to  use  the  editor  to  manipulate  the  file  in  each  case. 
Chapter  2  describes  how  to  enter  file  specifications. 


1.4.1    Inspecting  Files 

When  you  inspect  a  file,  you  are  able  to  use  only  those  functions  and  com- 
mands that  display  different  parts  of  the  file.  Therefore,  you  cannot  make  any 
changes  to  the  file.  Inspecting  a  file  can  be  especially  useful  when  you  want  to 
review  a  file  or  teach  someone  how  to  use  the  keypad  editor. 

To  inspect  a  file,  specify  an  input  file  but  no  output  file.  The  editor  opens  the 
input  file  and  displays  the  top  24  screen  lines  of  the  file,  with  the  cursor  on  the 
first  character  that  is  in  the  file.  To  look  at  other  parts  of  the  file,  you  use  the 
editor's  commands  and  functions  to  advance  and  back  up  the  cursor. 

Figure  1-4  shows  the  relationship  between  the  editor  and  the  file  you  are 
inspecting. 


KED/K52 
Commands  and  Functions 


Figure  1-4:    Inspecting  a  File 
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1.4.2    Creating  Files 

When  you  create  a  new  file,  you  can  use  all  of  the  editor's  functions  and 
commands. 

To  create  a  file,  specify  an  output  file  but  no  input  file.  The  editor  initially 
displays  a  blank  screen  except  for  one  special  symbol,  called  the  end-of-file 
symbol,  and  the  cursor.  With  VTIOO  terminals,  the  editor  uses  the  symbol  i 
as  the  end-of-file  symbol,  and  on  VT52s  the  editor  uses  the  symbol  1.  As  you 
type  the  new  material  on  the  keyboard,  the  editor  inserts  each  character  at 
the  cursor's  position  and  shifts  the  end-of-file  symbol  to  the  right  or  to  the 
next  line.  When  you  stop  creating  the  new  file  with  the  EXIT  command,  the 
editor  closes  the  output  file. 

Figure  1-5  shows  the  relationship  between  the  editor  and  th?  file  that  you 
create. 


KED/K52 

Commands  and  Functipns, 

including  insertion 


Main 
Output  File 


L 


Figure  1-5:    Creating  a  File 

1.4.3    Editing  Fiies 

When  you  edit  a  file,  you  can  use  all  of  the  editor's  functions  and  commands. 

To  edit  a  file,  specify  both  an  input  file  and  an  output  file.  The  editor  opens 
the  input  file  and  displays  it.  While  you  are  editing,  the  editor  displays  24 
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screen  lines  of  the  input  file,  and,  as  you  use  the  editor's  commands  and 
functions,  the  editor  immediately  shows  the  changes  that  you  make.  When 
you  stop  editing  by  issuing  the  EXIT  command,  the  editor  closes  the  output 
file.  After  the  session,  the  output  file  contains  your  changes.  Your  original 
input  file  remains  unchanged,  in  case  you  need  to  refer  to  it  again. 


Figure  1-6  shows  the  relationship  between  the  editor  and  the  main  output  and 
input  files. 


KED/K52 
Commands  and  Functions 


iM\%%Up 


Main 
Input  File 


Main 
Output  File 


L  __ 


Figure  1-6:     Editing  a  File 


1.4.4    Using  Auxiliary  Files 

The  most  common  uses  for  the  keypad  editor  involve  only  two  files,  the  main 
input  file  and  the  main  output  file.  In  addition  to  the  main  files,  you  can  also 
use  an  auxiliary  input  file  and  an  auxiliary  output  file.  Chapter  5  introduces 
auxiliary  files,  describes  the  commands  that  open  and  close  them,  and  pro- 
vides examples  of  when  they  are  useful. 
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1.5    How  to  Learn  to  Use  the  Keypad  Editor 

The  following  procedures  suggest  two  ways  to  learn  to  use  KKI).  Because 
everyone  seems  to  learn  how  computer  text  editors  work  in  his  or  her  own  way 
feel  free  to  start  experimenting  in  your  own  way  whenever  you  like. 

If  you  are  skilled  with  any  other  text  file  editor  that  DKilTAL  distributes,  use 
th(  following  procedure. 

1.  Read  the  rest  of  this  section. 

2.  Work  through  the  example  that  follows  these  suggestions. 
'■].    Read  Chapter  2.  Starting  and  Stopping  the  Keypad  Kditor. 

4.  Start  experimenting  with  KED's  functions.  Use  an  experimental  copy  of 
one  of  your  own  files.  Compare  other  functions  with  ones  that  the  example 
introduces,  iriowevor.  you  should  not  experiment  with  the  Sl'BSTI- 
TITK.  SPP:CINS.  replace,  or  APPEND  functions  until  after  you  have 
worked  with  the  other  functions.  Since  these  four  functions  work  differ- 
ently from  similar  functions  on  other  DKIITAL  supplied  editors,  it  is 
recommended  that  you  read  about  them  before  experimenting  with  them.) 

5.  Refer  to  Chapters  .'i  and  4  for  details  about  any  functions  you  are  espe- 
cially interested  in. 

6.  Read  Chapter  5.  Advanced  Keypad  Editor  Features,  and  learn  to  use  the 
features  described  there. 

If  you  are  less  confident  or  experienced  with  computer  text  editing,  u.se  the 
following  procedure. 

1.  Read  the  rest  of  this  section. 

2.  Work  through  tne  example  that  follows  these  suggestions.  The  example 
introduces  18  of  the  most  common  keypad  editor  functions. 

3.  Read  Chapter  2,  Starting  and  Stopping  the  Keypad  Editor. 

4.  Starting  at  the  beginning  of  the  function  summary  in  the  PDP- 1 1  Keypad 
Editor  Reference  Card,  use  a  small  ASCII  file  to  experiment  with  each 
function.  Although  the  descriptions  on  the  Reference  Card  are  short,  they 
cover  every  common  keypad  editor  feature. 

5.  Refer  to  full  descriptions  of  functions  in  Chapters  '■]  and  4  whenever  you 
think  you  need  them. 

6.  After  you  have  used  the  more  common  features  of  the  keypad  editor  for  a 
few  davs,  read  Chapter  5.  Advanced  Keypad  Editor  Features,  and  experi- 
ment with  the  features  described  there. 


1.6    Special  Terms  and  Concepts  in  this  Manual 

This  short  section  presents  the  full  definition  of  a  keypad  editor  uord  and 
seven  other  special  terms  that  appear  frequently  in  this  chapter. 
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N'ou  do  iiol  need  to  memorize  these  definitions.  I)ul  you  shouUi  read  them  and 
remember  that  the  terms  have  special  meanings  to  you  as  a  keypad  editor 
user. 


(n'RSOH'S  CHARACrHR 


WORD 


LINE  TERMINATORS 


The  cursor's  character  is  that  character  either 
underlined  h\-  the  cursor,  or  on  which  the  cursor 
is  superimposed. 

In  this  manual,  uord  always  means  a  ^eypad 
editor  word,  which  is,  in  most  cases,  a  string  of 
printing  characters  and  the  spaces  that  follow 
the  string. 

The  characters  do  not  have  to  be  letters  of  the 
alphabet;  t'li  digits  and  punctuation  marks, 
such  as  periods  (.).  commas  (. ).  and  quotation 
marks  ('  and  '").  can  be  parts  of  words. 

The  Horizontal  Tab  character,  a  string  of 
spaces  that  is  flanked  by  tabs  or  line  termina- 
tors, and  each  of  the  four  line  terminators  that 
the  keypad  editor  recognizes  are  words  by 
themselves. 

A  line  terminator  is  a  character  or  combination 
of  characters  that  causes  the  keypad  editor  to 
start  displaying  subsequent  characters  on  a 
new  screen  line.  The  keypad  editor  recognizes 
four  line  terminators: 

1.  P\)rmfeed  —  When  the  keypad  editor  de- 
tects a  P\)rmfeed  character  it  starts  dis- 
playing characters  at  the  left  margin  on  the 
next  screen  line. 

2.  \'ertical  Tab  --  When  the  keypad  editor 
detects  a  Vertical  Tab  character  it  starts 
displaying  characters  at  the  left  margin  on 
the  next  screen  line. 

3.  New  Line  —  This  manual  uses  the  term 
New  Line  for  the  most  common  line  termi- 
nator in  text  files.  The  New'  Line  terminator 
is  generated  by  the  Return  key  on  the  key- 
board. In  prompts,  the  keypad  editor  dis- 
plays the  terminator  as  the  Carriage  Return 
—  Linefeed  pair.  The  keypad  editor  func- 
tions that  process  individual  characters  al- 
ways treat  the  New  Line  terminator  as  a 
.single  character.  To  clarify  some  examples 
in  this  manual,  the  symbol  N  stands  for  the 
New  Line  terminator. 
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4.  Linefeed  by  itself  —  When  the  keypad  ed- 
itor detects  a  Linefeed  character  that  is  not 
preceded  by  a  Carriage  Return,  it  also 
starts  displaying  characters  on  the  next 
screen  line.  However,  the  screen  line  after  a 
Linefeed  by  itself  always  starts  directly 
below  the  Linefeed  character,  not  at  the  left 
margin. 


TEXT  LINE 


A  keypad  editor  text  line  is  composed  of  a  line 
terminator  and  all  of  the  characters  between  it 
and  the  preceding  line  terminator.  Note  that 
text  lines  and  screen  lines  are  not  necessarily 
the  same  because  a  text  line  may  be  too  long  to 
fit  on  one  screen  line.  However,  even  when  a 
text  line  is  too  long  for  one  screen  line,  the 
keypad  editor  still  treats  it  as  one  text  line. 


WRAPPED  LINE 


TARGET 


PAGE 


When  a  text  line  is  too  long  to  fit  on  one  screen 
line,  the  keypad  editor  uses  as  many  screen 
lines  as  necessary  to  display  the  line.  To  call 
attention  to  the  overlong  line,  the  keypad  editor 
precedes  each  extra  screen  line  with  a  special 
symbol.  This  is  called  a  'cipped  line  because 
the  keypad  editor  automatically  wraps  the  long 
text  line  into  lower  screen  lines.  The  symbols  ♦ 
and  -►  are  the  KED  and  K52  wrap  symbols, 
respectively. 

Most  of  the  keypad  editor's  functions  move  the 
cursor  forward  or  backward  in  your  file.  This 
manual  frequently  uses  the  term  target  for  the 
location  to  which  the  keypad  editor  moves  the 
cursor.  Different  functions  move  the  cursor  to 
different  targets.  For  example,  the  target  for 
the  WORD  function  is  the  beginning  of  a  word, 
and  the  target  for  the  EOL  function  is  a  line 
terminator. 

A  keypad  editor  page  is  a  unit  of  text  that  you 
can  define  to  suit  your  needs.  Initially ,  a  page 
ends  with  a  Formfeed  character  and  contains 
all  of  the  characters  back  to  the  preceding 
Formfeed  character.  However,  you  can  redefine 
a  page  by  using  the  SET  command  to  specify 
other  targets  for  the  PAGE  function. 
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SECTION 


A  keypad  editor  section  is  another  unit  of  text 
that  you  can  define  to  suit  your  needs.  Initially, 
a  section  is  16  consecutive  text  lines  forward  or 
backward  from  the  cursor.  However,  you  can 
also  define  a  section  by  using  the  SET  com- 
mand to  specify  other  targets  for  the  SECTION 
function. 


1.7   An  Example  of  the  Keypad  Editor  in  Action 

This  example  demonstrates  some  of  the  most  common  keypad  editor  func- 
tions. It  has  the  following  specific  purposes. 

•  To  show  you  what  the  screen  looks  like  while  you  are  editing. 

•  To  show  you  some  typical  ways  that  the  keypad  editor  changes  your  screen. 

•  To  show  you  the  keypad  editor's  cursor  and  end-of-file  symbol. 

•  To  introduce  the  special  function  keypad. 

•  To  demonstrate  that  the  names  of  the  keypad  editor  functions  explain  most 
of  what  the  functions  do. 

To  use  this  example,  you  need  a  copy  of  the  keypad  diagram  for  the  VTIOO  or 
the  VT52  and  the  file  SAMPLE. KED  on  the  distribution  volume.  Figures  1-1 
and  1-2  include  both  keypad  diagrams  as  does  the  PDP-11  Keypad  Editor 
Reference  Card.  You  may  find  it  useful  to  photocopy  one  of  the  diagrams  and 
attach  the  copy  to  your  terminal. 

The  first  time  you  work  with  this  example,  follow  each  instruction  carefully 
since  each  step  depends  on  the  preceding  step.  Therefore,  do  not  experiment 
while  working  with  the  example  for  the  first  time. 

Among  other  things,  this  example  shows  you  how  to  change  a  word  in  the  file 
to  another  word.  The  original  file  contains  several  occurrences  of  the  word 
//DATE//.  The  example  shows  you  how  to  erase  each  occurrence  and  insert 
the  current  date. 

Each  step  in  the  example  starts  with  an  instruction.  Read  the  instruction, 
then  look  at  your  screen  while  you  type  the  keypad  editor  function  the  instruc- 
tion asks  for.  Watch  how  the  keypad  editor  executes  the  function.  Finally, 
read  the  short  description  that  follows  the  instruction  in  the  example. 

1.  For  RT-11,  RSX-llM,  and  RSX-llM-PLUS,  install  DIGITAL'S  keypad 
editor  distribution  volume  in  an  available  drive.  IAS  users  do  not  need  to 
do  this. 

2.  For  RT-11,  RSX-llM,  and  RSX-llM-PLUS,  copy  the  file  SAM- 
PLE.KED  to  one  of  your  working  volumes.  For  IAS,  ask  your  System 
Manager  to  copy  SAMPLE. KED  from  the  Objects  Distribution  Media  to 
UFD  [1,1]  on  the  system  disk. 
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3.  Invoke  the  keypad  editor  and  specify  SAMPLE.KED  as  the  file  you  want 
to  edit.  Use  one  of  the  following  procedures,  or  have  an  experienced  col- 
league start  the  keypad  editor  for  you. 

For  RT-U: 

•  Read  Section  2.1.1.1  and  use  the  appropriate  procedure  for  your  system. 

•  Type  one  of  the  following  commands: 


for  a  VT52  terminal 
for  a  VTIOO  terminal 


EDIT/K52  SAMPLE.KED® 
EDIT/KED  SAMPLE.  KEDdl) 


For  RSX-llM  or  RSX-llM-PLUS: 

•  Start  the  MCR  (the  prompt  MCR>  will  appear  on  your  screen). 

•  Type  one  of  the  following  commands: 

for  a  VT52  terminal 
for  a  VTIOO  terminal 


K52  SAMPLE.KED 
KED  SAMPLE.KED® 


For  IAS: 

•  DCL  users  start  DCL.  (The  prompt  PDS  >  now  appears  on  your  screen.) 
Type  one  of  the  following  commands: 


for  a  VT52  terminal 
for  a  VTIOO  terminal 


EDIT/K52  SAMPLE.KED 
EDIT/KED  SAMPLE.KED 


•  MCR  users  start  MCR.  (The  prompt  MCR>    appears  on  your  screen.) 
Type  one  of  the  following  commands: 


for  a  VT52  terminal 
for  a  VTIOO  terminal 


K52  SAMPLE.KED 
KED  SAMPLE.KED 


4.  Type  your  initials  or  your  name.  Use  the  keyboard  keys  exactly  as  if  you 
were  using  a  standard  typewriter.  Use  the  Delete  key  on  the  keyboard  to 
correct  typing  mistakes. 

The  keypad  editor  inserts  each  letter  as  you  type  it. 

5.  Use  the  end-of-line  (EOL)  function.  Press  the  2  key  on  the  keypad. 
The  keypad  editor  moves  the  cursor  to  the  end  of  the  first  line. 

6.  Use  the  erase-left -word  (LINEFEED)  function.  Press  the  Linefeed  key  on 
the  keyboard. 

The  keypad  editor  erases  the  word  at  the  cursor's  left.  (The  keypad  editor  also  stores  the 
characters  you  have  erased,  in  case  you  want  to  recover  them.  A  later  step  shows  how  to 
recover  an  erasure.) 

7.  Type  the  current  date.  Use  the  letter  and  number  keys  on  your  keyboard. 
Use  the  Delete  key  to  correct  typing  mistakes. 

Again,  the  keypad  editor  displays  each  character  as  you  type  it. 
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8.  Use  the  SECTION  function.  On  a  VTIOO,  press  the  8  key  on  the  keypad. 
On  a  VT52,  first  press  the  bhie  keypad  key  and  then  the  downarrow  key. 

The  keypad  editor  moves  the  cursor  16  lines  forward.  The  keypad  editor's  default  defini- 
tion of  a  section  is  16  text  lines. 

9.  Use  the  WORD  function.  Press  the  1  key  on  the  keypad  three  times. 

For  each  WORD  function,  the  keypad  editor  moves  the  cursor  to  the  beginning  of  a  word. 
Word  and  other  keypad  editor  terms  are  defined  in  the  section  before  this  example. 
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10.  Use  the  erase-line-right  (DP^LLINE)  function.  On  a  VTKK),  press  the  PF4 
key  on  the  keypad.  On  a  VT52,  press  the  unlabeled  grey  key  on  the 
keypad. 

The  keypad  editor  does  tour  thinjis. 

•  It  erases  the  cursor's  character  and  the  characters  to  the  right  of  the  cursor. 

•  It  also  erases  the  Hue  terminator. 

•  It  stores  the  string  of  characters  (and  the  terminator). 

•  It  repaints  your  screen  to  show  the  effect  of  the  erasure. 

11.  The  preceding  step  erased  too  much.  Therefore,  use  the  undelete-line 
(UNDELLINE)  function  to  recover  the  entire  erasure.  On  a  VTIOO,  press 
the  PFl  key,  then  the  PF4  key  on  the  keypad.  On  a  VT52,  press  the  blue 
key  on  the  keypad,  then  the  unlabeled  grey  key  on  the  keypad. 

Most  of  the  keys  on  the  keypad  control  two  keypad  editor  functions,  a  standard  lunction 
and  an  alternate  function.  The  functions  shown  on  the  top  of  the  keys  in  the  keypad 
diagram  are  standard  functions.  The  functions  shown  on  the  hottoms  of  the  keys  are 
alternate  functions. 

For  example,  on  the  VTKK)  PF4  key,  DELUXE  is  the  standard  function.  I'nless  you 
specify  otherwise,  that  is  the  function  the  keypad  editor  will  execute  when  you  press  the 
P?"4  key.  The  alternate  function  of  the  PF4  key  is  to  restore  the  last  string  you  era.sed  with 
DELLINE  or  one  of  the  keypad  editor's  other  line-erasure  functions.  To  use  the  alternate 
function,  you  ha%e  to  use  the  (lOLD  function  as  a  prefix,  and  therefore  press  the.PFl  key 
first. 

In  this  step,  the  I'NDELLINE  function  restores  the  characters  you  just  erased,  including 
the  line  terminator,  and  the  keypad  editor  shows  the  effect  immediatel\. 

12.  Use  the  WORD  function  again.  Press  the  1  key  on  the  keypad  two  more 
times. 

Again,  the  keypad  editor  moves  the  cursor  two  iiords  forward. 

13.  Use  the  delete-to-end-of-line  (DELEOL)  function.  Press  the  GOLD  key 
and  then  the  DELEOL  key  —  on  a  VTIOO,  the  PFl  key,  then  the  2  key  on 
the  keypad.  On  a  VTfyi.  the  blue  key,  then  the  2  key  on  the  keypad. 

The  keypad  editor  erases  the  right-hand  part  of  the  line  and  stores  the  erasure.  However. 
DELPHI-  does  not  era.se  the  line  terminator. 

14.  Use  the  BOTTOM  function.  Press  the  GOLD  key  and  then  the  BOTTOM 
key  —  on  a  VTIOO,  the  PFl  key,  then  the  4  key  on  the  keypad.  On  a 
VT52,  the  blue  key.  then  the  4  key  on  the  keypad. 

The  keypad  editor  moves  the  cursor  past  all  of  the  characters  in  the  file.  The  keypad 
editor's  symbol  tor  the  bottom  of  a  file  is  s  on  a  VTIOO  and  I  on  a  \T52. 
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15.  The  keypad  editor's  searching  functions  move  the  cursor  d.rectly  to  the 
letters  and  strings  you  specify  in  the  FIND  function.  You  <  omplete  the 
FIND  function  with  a  model,  and  specify  the  direction  of  the  search.  The 
keypad  editor  moves  the  cursor  to  the  target  strings  in  the  file  that  match 
your  model. 

Tse  the  FIND  function.  On  a  VTKK),  press  the  ('.OLD  key  and  then  the 
FIND  key  —  the  FFl  key.  then  the  PF:^  key  on  the  keypad.  On  a  VT52, 
press  the  blue  key  and  the  8  key  on  the  keypad. 

The  keypad  editor  teinp(^:arily  erases  the  top  two  screen  lines  and  displays  the  prompt 

Model  : . 

Type  the  string  //DATE//  —  two  slashes,  the  word  DATE,  and  two 
slashes. 

The  keypad  editor  displays  eaeh  charaiter  of  the  model  as  you  type  it. 

Use  the  BACKIT  function  to  specify  a  backward  search.  Press  the 
BACKl'P  key  -     the  5  key  on  your  keypad. 

The  keypad  editor  searches  hackward  through  the  tile  tor  the  nearest  oceurrenie  ol  a  string 
that  matches  your  model.  When  the  key[)ad  editor  finds  a  matching  string,  it  places  the 
cursor  on  the  first  character. 


Hk  I'se  the  erase-word-right  (DELWORD)  function.  Press  the  DELWORD 
key  -  on  a  VTlOO.  the  hyphen  (-)  key  on  the  keypad  — ,  and  then  type 
the  current  date  again.  On  a  VT52,  press  the  9  key  and  then  type  the 
current  dato. 


The  keypad  editor  erases  the  next  word,  stores  the  characters  you  erased,  and  displays 
each  character  you  type. 

17.  Use  the  FINDNEXT  function.  Press  the  FINDNEXT  key  —  (m  a  VTlOO, 
the  PF3  key  on  the  keypad;  on  a  VT52,  the  8  key  on  the  keypad. 

The  keypad  editor  uses  the  latest  model  you  provided,  //DATE//  .  and  searches  back- 
ward lor  another  occurrence  of  a  matching  string  (The  keypad  editor  searches  backward 
because  BACKl'P  is  the  direction  you  specified  most  recently.)  The  cursor  is  now  on  one  of 
three  remaining  occurrences  of  the  string  /  /DATE/  /  in  the  file. 


18.  This  step  illustrates  an  easier  way  to  change  the  remaining  occurrences  of 
//DATE//  to  the  current  date.  The  SUBSTITUTE  function  uses  the 
keypad  editor's  paste  buffer  to  make  substitutions,  and  the  first  thing  you 
6()ve  to  do  is  put  your  substitution  string  in  the  paste  buffer. 

Use    the    begin-selection    (SELECT)     function.    Press    the    SELECT 
key  —  the  period  (.)  key  on  the  keypad. 

Type  in  the  current  date. 
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Use  the  cut-out  (CUT)  function.  Press  the  CUT  key  —  on  a  VTlOO.  the 
6  key  on  the  keypad;  on  a  VT52.  the  blue  key  and  the  'A  key  on  the 
keypad. 

The  SKLKCT  function  causes  the  keypad  editor  to  mark  the  cursdi's  position  as  one  end  of 
a  selected  string.  The  screen  does  not  ^how  any  et'tects  ot  selecting  until  you  move  the 
cursor.  On  a  V'TIOO.  as  you  type  in  characters,  the  keypad  editor  displays  them  in  reverse 
video  form. 

The  (T'T  function  erases  all  of  the  characters  that  are  in  the  current  selection,  and  the 
keypad  editor  stores  them  in  its  paste  hufier.  The  cursor  is  still  on  the  first  character  of 
//DATE//. 

19.  Use  the  substitution  (SUBSTITUTE)  function.  Press  the  GOLD  key  and 
then  the  SUBSTITUTE  key  —  on  a  VTIOO.  the  PFl  key,  then  the  Enter 
key  on  the  keypad;  on  a  VT52,  the  blue  key  and  the  Enter  key  on  the 
keypad. 

The  keypad  editor  substitutes  the  current  date  from  the  paste  buffer  for  the  search  target 
and  then  executes  the  FINDNEXT  lunction. 

20.  l^se  the  SUBSTITUTE  function  again  as  described  in  the  step  above. 

Each  time  you  use  the  Sl'BSTITl'TK  function,  the  keypad  editor  substitutes  and  then 
searches.  In  this  step,  the  keypad  editor  made  the  substitution  but  failed  to  find  another 
string  that  matched  the  model.  The  keypad  editor  signals  the  failure  by  ringing  the  hell  on 
your  terminal. 

21.  Use  the  HELP  function.  Press  the  HELP  key  —  on  a  VTIOO.  the  PF2  key 
on  the  keypad;  on  a  VT52,  the  red  key  on  the  keypad. 

When  the  Sl'BSTITlTE  function  failed,  the  keypad  editor  loaded  a  short  explanation  of 
the  failure  into  a  special  buffer.  HELP  causes  the  keypad  editor  to  teinporarily  erase  the 
bottom  three  lines  on  your  screen  and  display  the  explanation. 

22.  Use  the  restore-screen  (CTRL,^')  function.  Type  JcfRTw^  —  hold  the 
CTRL  key  down  while  you  type  the  letter  W  on  the  keyboard. 

The  keypad  editor  removes  the  HELP  message  and  restores  the  lines  it  temporarily  erased. 

23.  Use  the  EXIT  command  to  finish  this  example  and  to  .save  the  new  ver- 
sion of  the  sample  file  that  you  have  produced.  Press  the  GOLD  key  and 
then  the  COMMAND  key  —  on  a  VTIOO,  the  PFl  key.  then  the  7  key  on 
the  keypad.  On  a  VT52,  the  blue  key  and  then  the  7  key  on  the  keypad. 
Type  the  word  EXIT  on  the  keyboard  and  terminate  the  command  with 
the  Enter  k3y  on  '.le  keypad. 

The  keypad  editor  temporarily  erases  the  top  two  screen  lines  and  displays  the  prompt 
Command  : .  The  keypad  editor  displays  each  letter  of  the  command  as  you  type  it.  When 
you  press  the  Enter  key.  the  keypad  editor  moves  the  cursor  to  the  lower  left  corner  of  the 
screen,  pau.ses  briefly,  and  then  displays  its  identifying  message  again. 

24.  Type  gfRiTc)  or  (gED  —  hold  the  CTRL  key  down  while  you  type  the  letter 
C  or  Z  on  the  kevboard. 


When  the  keypad  editor  is  displaying  its  prompt 
operating  system  level.  On  RSX  1 IM  systems,  t 
and  fctRiC   returns  you  to  MC'K  level. 


.  RT  11  systems.  Cttrl  C  returns  you  to 
!   returns  you  to  operating  system  level 
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Chapter  2 

Starting  and  Stopping  the  Keypad  Editor 


2.1    Starting  a  Session 


2.1.1    Setting  the  Operating  System  for  a  Video  Terminal 

This  section  describes  the  settings  that  each  operating  system  requires  for  the 
keypad  editor.  For  example,  you  may  need  to  specify  that  your  terminal  is  a 
video  terminal,  not  a  printing  terminal.  You  may  need  to  specify  the  screen 
width  that  you  want  the  operating  system  to  assume  when  it  sends  characters 
to  your  terminal.  And  you  may  need  to  specify  how  you  will  be  setting  the 
transmit  and  receive  rates  on  your  terminal. 

For  some  systems,  the  system  manager  may  be  responsible  for  all  of  the 
settings  that  are  described  in  this  section.  If  you  are  not  sure  about  the 
settings  for  your  system,  check  your  local  operating  procedures  or  ask  your 
system  manager. 

2.1.1.1  Procedure  for  RT-11  —  The  RT-11  operating  system  must  be  set  for 
your  video  terminal.  The  system  settings  that  the  keypad  editor  requires 
depend  on  the  specific  RT-11  monitor  that  you  are  using.  Use  the  following 
procedures: 

1.  For  a  multi-terminal  monitor,  type  the  following  command: 

•  SET  TT  CONSOL=n  [where  n  is  the  k      al  unit  number  of  your 

terminal] 

2.  For  a  single-terminal  single  job  monitor,  type  only  the  following  com- 
mand: 

•  SET  TT  SCOPE 

2.1.1.2  Procedure  for  RSX-11M  and  RSX-11M-PLUS  —  With  the  RSX-llM 
and  RSX-UM-PLUS  operating  systems,  the  keypad  editor  does  not  require  a 
specific  set  of  operating  system  settings  except  that  the  terminal  must  be 
identified  properly  to  the  system  as  a  VT52  or  a  VTIOO.  Use  the  SET 
A'T52=TI:  command  to  run  K52  and  the  SET  A^T100=TI:  command  to  run 
KED.  The  keypad  editor  transmits  characters  to  the  terminal  and  receives 
characters  from  the  terminal  when  the  system  has  any  valid  combination  of 
settings  for  a  VTIOO,  VT52,  or  VT55  terminal. 
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2.1.1.3  Procedure  for  IAS  —  With  IAS,  the  keypad  editor  does  not  require  a 
specific  set  ol Operating  system  settings.  However,  the  editor  does  require  you 
to  identify  the  terminal  to  the  system  as  a  VT')2  or  VTlOO.  The  keypad  editor 
transmits  characters  to  the  terminal  and  receives  characters  from  the  ter- 
minal when  the  system  has  any  valid  combination  of  settings  for  a  VTKK)  or 
VTri2.  Identity  VVnn  terminals  as  VT52's. 

DCL  users  can  use  the  PDS  commands  SET  TP:RMINAL  VT52  before  run- 
ning K.Vi.  and  SET  TERMINAL  VTlOO  before  running  KED. 

MCR  users  can  use  the  M(^R  commands  TER  /VT52  before  running  K52  and 
TER  /VTKK)  betbre  running  KED. 

2.1.2    Setting  VT100  Terminal  Characteristics 

To  set  your  VTlOO  terminal  characteristics,  use  the  VTlOO  SETUP  A  and 
SETUP  B  modes.  Refer  to  your  VTlOO  User  Guide  for  detailed  instructions 
about  the  SETUP  modes. 

The  keypad  editor  accepts  any  combination  of  settings  that  is  valid  for  your 
operating  system.  With  KED,  you  can  also  change  your  terminal  screen  width 
and  the  video  background  while  you  are  editing.  Section  3.3.2  describes  the 
KED  commands  for  changing  the  width  and  background. 

You  can  choose  either  the  block  cursor  i  or  the  underline  cursor  (_).  The 
block  cursor  is  easier  to  see,  and  the  examples  in  this  manual  show  the  block 
cursor. 

NOTE 

With  RSX-llM,  RSX-llM-PLUS,  and  IAS  systems,  you  can 
run  KED  with  your  terminal  set  for  either  the  VT52  or  the 
ANSI  modes.  However,  when  you  exit  from  KED,  your  ter- 
minal will  alwavs  be  set  to  the  ANSI  mode. 


2.2    Running  the  Keypad  Editor  on  RT-11  Systems 

You  can  run  the  keypad  editor  on  RT-11  V4  systems  in  three  ways: 

1.  By  using  the  RT  11  interactive  command  EDIT  with  the  command  option 
/KED  or  /K52. 

2.  By  using  the  RT-11  SET  EDIT  KED  or  SET  EDIT  K52  commands  and 
then  the  EDIT  command  without  the  corresponding  option. 

3.  By  using  the  RT-11  interactive  command  R  or  RUN  and  then  typing  a 
Command  String  Interpreter  (CSI)  file  specification  line. 

On  earlier  versions  of  RT-11  (V3  and  V3B),  you  can  use  only  the  third  method 
to  run  the  keypad  editor.  The  earlier  versions  do  not  support  the  /KED  or 
/K52  options  for  the  EDIT  command  or  the  KED  or  K52  arguments  for  the 
SET  EDIT  command. 
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When  you  use  the  RUN  or  R  command,  the  keypad  editoi  returns  you  to  the 
CSI  level  and  displays  the  CSI  prompt  (*).  The  special  settings  that  you  have 
made  and  the  contents  of  the  keypad  editor's  buffers  are  preserved  for  your 
next  keypad  editor  session,  and  you  can  start  another  keypad  editor  session  by 
completing  another  CSI  file  specification  string.  Or  you  can  return  to  the 
RT-11  monitor  level  by  typing  C:trl'c")  .  The  keypad  editor  settings  and  buffer 
contents  are  lost  only  when  you  respond  to  the  CSI  prompt  by  typing  ipWc] . 

The  following  sections  describe  how  to  use  both  the  EDIT  command  and  the 
RUN  or  R  command.  If  you  are  using  RT-11  V4,  read  both  sections.  However, 
if  you  are  using  only  an  earlier  version  of  RT-11,  skip  to  Section  2.2.5. 


2.2.1    EDIT,  R  and  RUN  Command  Default  Values  Under  RT-11 

Table  2-1  summarizes  the  command  default  values  for  the  keypad  editor 
running  under  RT-11. 


Table  2-1:    EDIT,  R,  and  RUN  Command  Default  Values  under  RT-11 


Item 


Text  editor 


KED  &  K52 
volume 

Editing  process 


Input  volume 

Output  volume 

Input  file 
name  &  type 

Output  file 
name  &  type 

Maximum 
output 
file  size 


Default 


RT-ll's  default  text  editor  is  EDIT,  the  program  that  is  described  in 
Chapter  5  of  the  RT-1 1  System  i'ser's  Guide.  Section  2. 2. .3  describes  how 
you  can  specify  the  keypad  editor  as  the  default  text  editor  for  your  own 
versions  of  the  RT-11  system. 

For  the  EDIT  and  R  commands,  the  RT-11  system  volume,  SY:.  For  the 
RUN  command,  the  default  storage  volume,  DK:. 

Unless  you  specify  a  different  option,  KED  and  K52  automatically  back 
up  the  file  you  specify  on  the  same  volume  that  contains  the  input  file. 

The  RT-11  default  storage  volume,  DK:. 

The  RT-11  default  storage  volume,  DK:. 

\o  default;  must  be  specified. 

For  the  /CREATE  and  /OUTPUT  options,  must  be  specified.  For  editing 
with  automatic  backup,  KED  and  K52  use  the  original  file  name  and 
type. 

Depends  on  the  number  of  contiguous  free  blocks  on  the  output  volume. 
KED  and  K52  allocate  the  larger  of  the  following  two  sizes: 

•  One-half  of  the  largest  number  of  contiguous 
free  blocks. 

•  All  of  the  second-'argest  number  of  contigu- 
ous free  blocks. 
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2.2.2    Using  the  RT-11  Interactive  Command  EDIT 

The  RT-11  interactive  command  EDIT  invokes  the  text  editors  that  DIG- 
ITAL distributes  for  use  with  RT-11.  Chapter  4  in  the  RT-U  System  User's 
(hiide  describes  the  EDIT  command  in  detail  and  the  following  sections  sum- 
marize how  to  use  the  command  to  start  the  keypad  editor. 

Version  4  of  RT-1 1  provides  two  EDIT  command  options.  /KED  and  /K52,  for 
the  two  versions  of  the  keypad  editor.  With  the  options,  the  full  EDIT  com- 
mand svntax  is  as  follows: 


EDIT 


~f/h£D\ 


"[/CREATE]     SP,,  inpu t -fiU'spt'c [/ALLOCATE: size ] 
/INSPECT    SP;  input -fitespec 
/OUTPUT  :()ufpu' f-/'i7«'.s;:)rr[  /ALLOCATE  :.s(>c]    LSp   input-filcspa 


Use  standard  RT-11  file  specifications  as  described  in  Chapters  3  and  6  of  the 
RT-11  System  User's  Guiae.  The  /CREATE,  /INSPECT.  /OUTPUT,  and 
/ALLOCATE  options  are  described  in  the  following  sections. 

2.2.3    Specifying  the  Keypad  Editor  As  Your  Default  Editor 
Under  RT-11 

If  you  want  the  keypad  editor  to  be  the  default  text  editor  that  RT-11  starts 
when  you  use  the  EDIT  command,  use  the  SET  EDIT  command.  The  forms 
of  the  command  for  KED  and  K52  are  as  follows: 

SET  EDIT  KED  © 
SET  EDIT  K52  H! 

You  can  also  include  the  SET  EDIT  KED  or  SET  EDIT  K52  command  in 
your  startup  indirect  command  file.  If  you  do  so,  the  indirect  command  file 
will  specify  KED  or  K52  as  your  default  text  editor  each  time  you  boot  your 
RT-11  system  volume. 

When  KED  f^r  K52  is  the  default  text  editor,  you  do  not  need  to  add  the 
corresponding  option  (/KED  or  /K52)  to  the  EDIT  command  when  you  want 
to  start  the  keypad  editor.  However,  you  will  need  to  use  the  /EDIT  option  if 
you  want  to  use  the  standard  RT-11  text  editor  EDIT. 

2.2.4    Using  Options  with  the  RT-11  EDIT  Command 

This  section  describes  how  to  use  the  options  with  the  EDIT  command  to 
specify  the  following  editing  processes  with  KED  and  K52: 

1.  Editing  files  with  automatic  backup 

2.  Inspecting  files 

3.  Creating  new  files 

4.  Editing  files  and  using  new  output  file  names 

5.  Specifying  the  maximum  output  file  size 


2-4       Starting  and  Stopping  the  Keypad  Editor 
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2.2.4.1  Editing  Files  with  Automatic  Backup  ~  The  keypad  editor's  default 
editing  process  automatically  creates  a  backup  file.  When  you  finish  editing  a 
file,  the  keypad  editor  renames  your  input  file  with  the  .BAK  file  type  and 
stores  the  new  file  that  you  produce  under  the  input  file  name  and  type.  F^or 
example,  if  you  begin  an  editing  session  with  the  following  command,  at  the 
end  of  the  session  KED  stores  the  original  version  ofREPORT.TXT  under  the 
name  REPORT. BAK  and  the  new  version  of  the  file  under  the  name  RE- 
P(3RT.TXT. 

EOn/KtL     RFPQRT.TKT    laETi 

2.2.4.2  Inspecting  Files  —  When  you  add  the  /INSPECT  option  to  the  EDIT 
command,  the  keypad  editor  displays  the  original  file  that  you  specify,  but 
the  keypad  editor's  functions  and  commands  that  modify  a  file  are  disabled. 
You  can  use  only  the  commands  and  functions  that  move  the  cursor  and 
control  auxiliary  output  files.  Therefore,  although  you  cannot  make  any 
changes  to  a  file  that  you  are  inspecting,  you  can  create  auxiliary  output  files. 
Except  for  auxilisry  output  files,  the  keypad  editor  does  not  erase,  create,  or 
rename  any  files  when  you  finish  inspecting  a  file.  For  example,  at  the  end  of 
an  editing  session  that  you  begin  with  the  following  command,  the  file  IN- 
SPEX.PRG  is  unchanged. 

EDIT/KED/  INSPECT  INSPE;<.PRG  gff 

2.2.4.3  Creating  New  Files  —  When  you  add  the  /CREATE  option  to  the 
EDIT  command,  the  keypad  editor  creates  a  new  file  when  you  finish  editing. 
For  example,  at  the  end  of  an  editing  session  that  you  begin  with  the  following 
command,  KED  stores  a  ne v,'  file  under  the  name  PR26.DAT. 

EDIT/KED/CREATE     PR26.DAT    I® 

2.2.4.4  Editing  Flies  and  Using  New  Output  File  Names  —  When  you  add  the 
/OUTPUT  option  to  the  EDIT  command  and  specify  an  output  file  name,  the 
keypad  editor  opens  the  output  file  and  displays  the  original  file  that  you 
specify.  All  keypad  editor  commands  and  functions  are  enabled.  When  you 
finish  editing,  the  keypad  editor  closes  the  output  file  and  leaves  your  original 
file  unchanged.  For  example,  at  the  end  of  an  editing  session  that  you  begin 
with  the  following  command,  KED  stores  the  changes  you  have  made  in  a  new 
file  named  SPCOUT.FOR  and  leaves  the  file  GENIN.FOR  unchanged. 

EDIT/KED/OUTPUT-.SPCOUT.FOR    GENIN.FOR    (H) 

2.2.4.5  Specifying  the  Maximum  Output  File  Size  —  When  you  add  <he  /AL- 
LOCATE option  to  the  EDIT  command,  the  keypad  editor  uses  the  number 
you  specify  as  the  maximum  size  in  blocks  for  the  output  file.  For  example, 
each  of  the  following  commands  specifies  196  blocks  for  the  output  file. 

EDIT/KED  SPRINT. SPC/ALLOCATE : 19B  m 
EDIT/KED/CREATE  W  I  NTER  .  SPC  /  ALLOCATE  :  1  9B  flEi 
EDIT/KED/0UTPUT:FALL.5PC/AlL0CATE: 19G  SUMMER. SPC  m 

The  maximum  input  file  size  for  editing  with  the  keypad  editor  is  16383 
blocks.  Therefore,  16383  blocks  is.also  the  largest  output  file  size  that  you  can 
allocate. 
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2.2.5    Using  the  RT-11  Interactive  Commands  R  and  RUN 

Start  any  keypad  editor  session  with  the  RT  11  RTN  or  R  command.'  If 
KKD.SAV  and  Kr)2.SA\'  are  on  your  system  volume,  you  do  not  need  to 
specify  a  volume  in  the  command.  F^or  example,  with  KKD.SAV  on  volume 
SV:  and  with  that  solume  installed  in  drive  I)X():,  the  following  commands 
are  equivalent. 


R    K  E  D  RET: 

R    SY:KEDIRET) 


IS^':  is  the  default  volume. 


If  you  have  stored  KFID.SAV  and  Ko'i.SAV  on  another  volume,  you  must  type 
the  device  specification  for  the  volume  explicitly  in  the  Rl'N  or  R  command. 
The  following  examples  show  two  explicit  device  specifications. 


RUN    RK0:KEDRET 
RUN    DYl  :KED  RET 


2.2.5.1  The  RT-11  CSI  File  Specification  String  —  When  you  have  completed 
the  RrX  or  R  command,  the  keypad  editor  uses  the  RT  11  Command  String 
Interpreter  (CSI)-  to  prompt  you  for  a  file  specification  string.  The  CSI 
prompt  is  an  ast^-iisk  (*).  The  form  of  the  file  specification  string  you  type 
determines  whether  you  are  inspecting  or  editing  a  file. 

2.2.5.2  Editing  Files  with  Automatic  Bacltup  —  The  CSI  strings  for  editing  files 
with  automatic  backup  can  be  in  two  forms: 

1.  output -filv[ /  (\:  size]    tiri^mal-f He  (Hi) 

2.  ()rifiinal-filc\  I A  :  size]  iMt) 

You  can  dd  the  I k:s\ze  option  to  any  output  file  specification.  Complete  the 
option  in  the  same  way  as  for  the  EDIT  command  /ALLOCATE  option,  as 
described  in  Section  2.2.4.5. 

In  the  first  form,  the  specifications  tor  the  output  file  and  original  file  must  be 
the  same  if  you  want  the  keypad  editor  to  use  the  automatic  backup  process. 

For  example,  at  the  end  of  an  editing  session  that  you  begin  with  the  following 
commands,  KED  stores  the  original  version  of  EXAMP.FOR  under  the  name 
EXAMP.HAK  and  the  new  version  of  the  file  under  the  name  EXAMP.FOR. 

.  R    h  E  D    CreTi 

*RK  1  :  EXAMP  .  FOR  =  RK  1  :  EXAMP  .FOR    jET) 


Chapter  4  in  the  HT  1 1  S\st<'m  I 'sir's  (/i/if/c.  liiterai'tive  Commatuis,  riocuiiients  the  Hl'N 
command  in    'ftail. 

Chapter  fi  in  the  RTll  Systi'm   Csit's  (luidr  includes  details  on  the  Command  String 
Interpreter. 


2-6        Starting  and  Stopping  the  Keypad  Editor 


The  tbllowinf;  example  has  the  same  effect  as  the  prei-eding  example. 

Typing  only  the  specification  lor  the  input  file  that  you  want  to  edit  is  the 
shortest  way  to  specily  the  keypad  editor's  automatic  backup  process. 

,R     KED     iRET} 

*RK  1  :e;;amp.for  m, 

2.2.5.3  Creating  New  Files  —  The  CSI  string  for  creating  a  file  is  a  single  file 
specification  followed  by  the  /C  option  and  terminated  with  the  Return  key. 

If  another  file  with  the  same  specification  exists,  the  keypad  editor  responds 
with  a  warning.  You  can  cancel  the  session;  or  you  can  continue  the  session, 
erase  the  existing  file,  and  create  a  new  file  under  the  old  name. 

P^xamples:  The  following  example  creates  a  new  file  on  the  default  storage 
device  DK:. 

.  R    KED  RET- 

♦  EKAMP.b'aS/C'®  IDK:  is  the  default  (\SI  device.  KP^D 

shows    an    empty    screen    with    the 
cursor  at  the  upper  left  corner.] 

The  following  example  creates  a  new  file  on  DECpack  drive  RKl:.  K52  warns 
that  another  file  with  the  same  name  exists.  It  will  be  erased  becau.se  the  user 
responds  Y  (for  \e.s)  to  the  warning. 

.R    kszCreT. 

♦  RKl:CURRENT.DAT/C(REL 

'7  K  E  D  -  W  -  0  i.i  t  p  i.i  t     file     exists.     C  o  ra  i  ri  u  e     (  ^'  .  N  )     "?  ,  pr 

[Y  means  that  the  existing  file 
RKliCrRRXT.DAT  will  be  era.sed. 
K52  shows  an  empty  screen  with  the 
cursor  at  the  upper  left  corner.] 

The  following  example  creates  a  new  file  on  diskette  drive  DXO:.  KED  warns 
that  another  file  with  the  same  name  exists.  It  is  preserved  because  the  user 
responds  N  (for  no)  to  the  warning. 

.R    KED^BEt: 

*D);0:ARGLO.FOR/C-® 

?  K  E  D  -  W  -  0  Li  t  p  u  t     file     exists.     C  o  v,  t  i  n  u  e     (  N'  .  N  )     "?  N  *ET' 

IN  means  that  the  existing  file 
DX():ARGLO.FOR  will  not  be 
erased.  KED  identifies  itself  and  dis- 
plays the  rsi  prompt.) 

2.2.5.4  Inspecting  Files  —  The  CSI  siring  to  inspect  a  file  that  exists  is  a 
single  file  name  followed  by  the  /I  option  terminated  with  the  Return  key. 
Note  that  the  default  storage  device,  DK:,  is  the  default  device  for  all  CSI  file 
specifications.' 


Chapter  H  in  the  RT-ll  System  I'ser's  (luide.  System  Conventions,  includes  details  on 
permanent  device  names,  and  Chapter  4,  Interactive  Commands,  covers  the  ASSKJN  ind 
DEASSKl.N  commands  and  ways  you  can  assi^jn  the  loj^ical  name  DK:  to  different  physical 
devices. 
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Examples:  The  following  example  shows  the  complete  procedure  lor  starting 
KED  to  inspect  a  file  on  the  default  storage  device  DK:. 


*RPT2SG.T)<T/I® 


[RT-11  monitor  prompt! 

[SY:  is  the  default  volume.) 

[DK:  is  CSI's  default  device.  KED 

displays  the  top  24  screen   lines  of 

DK:  RPT296.TXT.  1 


The  following  example  shows  complete  procedures  to  start  K52  to  inspect  a 
file  that  is  on  DECpack  drive  RKl:. 


.  R    K  5  2  (RET) 

*RK  1  :  PROGl  .BAS/Idi;' 


[RT-11  monitor  prompt] 

[K52  displays  the  top  24  screen  lines 
of  RKl:PROGl.BAS.l 


2.2.5.5  Editing  Files  and  Using  New  Output  File  Names  —  The  CSI  string  for 
editing  files  and  using  new  output  file  names  is  in  the  following  form: 

output-file  [  /  A  :  size  1  =  original- file   (H) 

The  specifications  for  the  output  file  and  original  file  must  be  different  if  you 
want  the  keypad  editor  to  store  the  edited  version  of  the  file  under  a  new  file 
name.  The  /A:size  option  is  used  in  the  same  way  as  the  EDIT  command 
/ALLOCATE  option  described  in  Section  2.2.4.5. 

For  example,  at  the  end  of  a  session  that  you  begin  with  the  following  com- 
mands, KED  stores  the  edited  version  of  TEMP. DAT  under  the  name 
EXPT44.DAT. 


.R    KED    m 

*EXPT^^ .DAT=TEMP.DAT    (H) 


2.2.6    Restrictions  for  RT-11  Systems 

This  section  describes  the  restrictions  for  running  the  keypad  editor  on  RT-11 
operating  systems. 

2.2.6.1  File  Protection  —  Except  for  editing  with  automatic  backup  as  de- 
scribed in  Section  2.2.5,  the  keypad  editor  displays  the  following  message 
when  an  output  file  specification  is  the  same  as  for  a  file  that  already  exists  on 
the  output  volume: 

"?  K  E  D  -  W  -  0  Li  t  F  u  t  file  exists.  Continue  (  Y  » N  )  "^ 
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When  the  message  appears,  you  can  cancel  the  editing  session  by  typing  ^trDc) 
or  N  (for  no).  Or  you  can  continue  the  session,  erase  the  existing  file,  and 
create  a  new  file  under  the  old  name  by  typing  Y  (for  yes). 

In  the  following  example,  KED  warns  that  diskette  DXl:  already  contains  a 
file  named  MAYQUE.BAS.  If  the  user  stops  the  keypad  editor  with  the  EXIT 
command,  the  file  will  be  erased  because  the  user  responds  >'e.s  to  the  warning. 

.EDIT/KED/0UTPUT:D)(1  :I1AY0UE  .  BAS    DXO  :  PG^5  1  .  BAS    (IB 
'^KED-N-Out  put    file    exists,     Continue     (YiN)''    Ygfj) 

However,  if  the  user  stops  the  keypad  editor  with  the  QUIT  command,  the  old 
file  will  not  be  disturbed. 

RT-11  does  not  support  file  version  numbers  as  the  RSX  family  of  operating 
systems  do. 

2.2.6.2  Output  File  Size  —  Under  RT-11,  the  keypad  editor  searches  the 
output  volume  for  contiguous  free  space  in  which  to  store  a  file  that  you  are 
creating.  Then  the  keypad  editor  allocates  the  free  space  for  your  editing 
session.  In  the  following  three  cases,  the  keypad  editor  displays  messages 
about  the  free  space  it  has  allocated.  Appendix  A  provides  guidelines  for  you 
to  follow  when  the  messages  appear. 

1.  When  the  output  volume  does  not  contain  any  contiguous  free  space  that 
is  as  large  as  your  original  file,  KED  and  K52  both  display  the  following 
message  and  return  immediately  to  the  RT-11  monitor  or  the  CSI  prompt: 

"^  K  E  D  -  F  -  0  u  t  p  u  t  file  shorter  than  input  file 

2.  When  the  largest  amount  of  free  space  on  the  output  volume  is  less  than 
10  blocks  larger  than  your  original  input  file,  KED  and  K52  both  display 
the  following  message: 

?KED-W-Only  MMMMMM  blocks  auailable  for  insertions 
-  C  0  n  1 1  n  u  e  (Y.N)'' 

The  keypad  editor  also  displays  the  message  when  you  want  to  create  a 
new  file  and  the  output  volume  contains  less  than  10  blocks  of  free  space. 

3.  When  you  add  material  to  a  file  that  you  are  creating  or  editing  and  the 
file  becomes  as  large  as  the  free  space  allocated  for  it,  the  keypad  editor 
refuses  to  accept  more  material  and  signals  you  each  time  you  try  to  insert 
more.  You  can  use  the  HELP  function  to  see  an  explanation  of  the  signal. 
For  example,  if  a  file  you  are  creating  reaches  its  maximum  size  while  you 
are  typing  on  the  keyboard,  the  keypad  editor  signals  the  error  by  ringing 
the  bell  on  your  terminal  or  reversing  the  video  background  of  your  ter- 
minal's screen.  If  you  then  use  the  HELP  function,  the  keypad  editor 
displays  the  following  message: 

Insert  f  i  n  id  s  file  full 
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2.2.6.3  Accidentally  Using  the  Wrong  Kind  of  Terminal  —  The  keypad  editor  is 
designed  only  for  VT52s,  VT55s,  and  the  VTIOO  series  of  video  terminals.  If 
you  accidentally  try  to  run  the  keypad  editor  from  a  hard-copy  terminal,  such 
as  the  LA36  DECwriter,  try  the  following  procedures  to  recover  control  of  your 
system: 

•  Type  ^TRUc)  several  times  if  the  EDIT  command  prompt  FILE?  or  CSI 
prompt  (*)  has  been  displayed.  Continue  working  normally  when  the  RT-U 
monitor  prompt  ( ♦ )  appears. 

•  Re-boot  your  system  if  you: 

1.  Typed  the  EDIT/KED  or  EDIT/K52  command  and  included  a  complete 
file  specification. 

2.  Responded  to  the  CSI  prompt  with  a  file  specification. 

If  you  accidentally  run  KED  from  a  VT52  terminal,  repeat  the  following 
procedure  until  the  RT-U  monitor  prompt  ( . )  appears: 

1.  Type  !5trl/c)  several  times  to  return  to  the  RT-U  monitor  level.  In  most 
cases,  the  monitor  prompt  will  not  be  displayed  in  this  step,  however. 

2.  Turn  your  VT52  off,  then  on. 

3.  Press  the  Return  key.  In  most  cases,  the  monitor  prompt  appears  after  this 
step. 

If  you  have  included  the  SET  EDIT  KED  or  SET  EDIT  K52  command  in 
your  start-up  indirect  command  file,  the  EDIT  command  by  itself  will  cause 
one  of  the  problems  described  above  if  your  system  console  is  the  wrong  kind 
of  terminal. 


2.3    Running  the  Keypad  Editor  on  RSX-11I\/I  Systems 

You  can  run  the  keypad  editor  on  RSX-UM  V3.2  systems  and 
RSX-UM-PLUS  Vl.O  systems.  For  RSX-UM  systems,  the  system  must  be 
built  with  the  full-duplex  terminal  driver  during  the  system  generation  proce- 
dure. 

If  you  are  uncertain  about  how  your  RSX-UM  system  has  been  built,  ask 
your  system  manager,  and  if  you  are  responsible  for  building  systems  yourself, 
refer  to  the  installation  instructions  in  the  RSX-UM  System  Generation 
Manual. 

For  RSX-UM-PLUS  systems,  -he  full-duplex  terminal  driver  is  the  only 
terminal  driver  available.  You  can,  therefore,  use  the  keypad  editor  with  any 
RSX-UM-PLUS  system. 
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This  section  presents  the  details  about  running  the  keypad  editor  that  apply 
to  all  RSX-UM  systems  as  well  as  to  RSX-llM-PLUS  systems  when  you  are 
using  the  MCR  Command  Line  Interpreter  (CLI).  With  RSX-llM-PLUS 
systems  you  can  also  use  the  DIGITAL  Command  Language  Interpreter 
(DCL)  EDIT  command  as  described  in  Section  2.4. 


You  can  run  the  keypad  editor  on  RSX-UM  V3.2   and  RSX-llM-PLUS  VI 
systems  in  two  ways: 

1.    By  calling  the  keypad  editor  directly  with  the  task  names  KED  or  K52  if 
the  keypad  editor  has  been  installed  as  an  RSX-UM  system  utility. 


2.    By  using  the  RSX-UM  Monitor  Console  Routine  (MCR)  command  RUN, 
and  specifying  the  keypad  editor. 

When  you  call  the  keypad  editor  directly  with  the  task  names  KED  or  K52 
and  include  a  file  specification  string  in  the  call,  the  keypad  editor  returns  you 
to  the  MCR  level  when  you  finish  an  editing  session.  Any  special  settings  that 
you  made  while  using  the  keypad  editor  and  anything  that  you  have  stored  in 
the  keypad  editor's  buffers,  such  as  the  paste  buffer,  are  lost. 


When  you  run  the  keypad  editor  with  the  RUN  command,  the  keypad  editor 
returns  you  to  the  keypad  editor  file  specification  string  level  and  displays  the 
prompt  KED>  before  returning  you  to  the  MCR  level.  The  special  settings 
that  you  made  and  the  contents  of  the  keypad  editor's  buffers  are  preserved 
for  your  next  keypad  editor  session.  When  the  prompt  KED  >  is  displayed,  you 
can  start  another  keypad  editor  session  by  compleang  another  keypad  editor 
file  specification  string,  or  you  can  return  to  the  MCR  level  by  typing  glD. 
The  settings  and  buffer  contents  are  lost  only  when  you  respond  to  the  prompt 
KED>  by  typing  gmuzl. 


With  the  keypad  editor  installed  in  your  system,  you  can  also  call  the  keypad 
editor  directly  with  the  task  names  KED  or  K52  without  including  a  file 
specification  string.  This  case  is  the  same  as  for  the  RUN  command. 


The  following  sections  describe  the  two  most  common  methods  of  running  the 
keypad  editor.  The  descriptions  assume  that  the  system  library  device  LB: 
contains  the  keypad  editor  or  that  the  keypad  editor  is  one  of  the  installed 
utilities  in  your  RSX-UM  system.  Refer  to  the  RSX-llM/M-PLUS  MCR 
Operations  Manual  for  full  descriptions  of  the  RUN  command  and  MCR 
procedures.  The  MCR  Operations  Manual  also  describes  how  to  use  the  MCR 
INS  command  to  install  utilities  such  as  the  keypad  editor. 
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2.3.1    Start-up  Default  Values  Under  RSX-HM 


Table  2-2  summarizes  the  command  default  values  for  the  keypad  editor 
running  under  RSX-UM. 


Table  2-2:    Start-up  Default  Values  Under  RSX-IIM 


Item 


Input  &  output 
UIC 

Input  &  output 
volumes 

Input  file 
name  &  type 

Output  file 
nan;e  &  type 


Input  file 
version 

Output  file 
version 


Output  file 
protection 


Output  file 
carriage 
control 
attribute 

Size  of  the 
temporary 
file 


Default 


The  LOGON  UIC.  Use  the  SET  /UIC  command  or  the  ,V\C  option  for 
the  RUN  command  to  specify  a  different  default. 

The  volume  installed  in  the  default  device  SY:.  Use  the  ASN  command 
to  assign  the  logical  device  name  SY:  to  different  physical  devices. 

No  default;  must  be  specified. 

When  creating  a  new  file  from  an  existing  file,  must  be  specified.  When 
creating  a  new  version  of  a  file,  the  keypad  editor  uses  the  input  file  name 
and  type. 

The  latest  version  of  the  input  file  that  is  on  the  input  volume. 

When  creating  a  new  file,  the  keypad  editor  assigns  version  1.  Otherwise, 
the  keypad  editor  assigns  a  version  number  that  is  one  plus  the  version 
number  of  the  latest  version  that  is  on  the  output  volume. 

When  creating  a  new  file,  the  default  file  protection.  When  editing  a  file, 
the  keypad  editor  sets  the  output  file  protection  to  match  the  input  file 
protection.  (The  RSX-11  Ihilities  Manual  describes  how  to  change  the 
file  protection.) 

When  creating  a  new  file,  the  keypad  editor  assigns  the  implied  carriage 
control  attribute.  Otherwise,  the  keypad  editor  assigns  the  input  file's 
attribute. 


The  size  of  the  temporary  file  limits  the  amount  by  which  you  can  in- 
crease the  sire  of  the  input  file  in  one  keypad  editor  session.  When  you 
create  an  entirely  new  file,  the  default  size  of  the  temporary  file  is  50 
blocks.  Otherwise,  the  default  size  is  50  blocks  larger  than  the  input  file. 


2.3.2    Calling  the  Keypad  Editor  with  the  Task  Names  KED  and 
K52 

With  the  keypad  editor  installed  in  your  system,  you  can  call  the  keypad 
editor  directly  by  typing  the  task  name.  The  two  forms  of  the  call  are: 

1.     >KED  file- specification- stringy  options]  (RH) 
>K52  file-specification-stringi/options]  ® 


>KED 

>K52  m 
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When  you  use  the  first  form,  the  file  specification  string  you  type  specifies  one 
of  the  four  following  editing  processes  and  the  keypad  editor  starts  immedi- 
ately. 

1.  Storing  a  new  version  of  a  file  and  using  the  original  file  name 

2.  Inspecting  a  file 

3.  Creating  a  new  file 

4.  Storing  a  new  version  of  a  file  and  using  a  new  output  file  name 

The  different  file  specification  strings  and  options  are  described  in  the  fol- 
lowing sections. 

When  you  use  the  second  form  of  the  direct  call  with  the  task  names  KED  and 
K52,  the  keypad  editor  displays  the  prompt  KED;  or  K52 ;  .  Respond  to  the 
prompt  by  typing  one  of  the  file  specification  strings  described  in  the  fol- 
lowing sections  and  add  the  option  that  you  want  the  keypad  editor  to  use. 

NOTE 

RSX-UM  systems  automatically  use  the  input  file  with  the 
highest  version  number  and  store  the  output  file  with  the  next 
higher  version  number. 

Although  the  system  and  the  keypad  editor  accept  an  explicit 
output  file  version  number,  by  using  one  you  may  accidentally 
reduce  the  security  of  your  files.  For  example,  if  you  specify  an 
output  file  version  number  that  is  lower  than  the  version 
number  of  your  input  file,  the  highest  version  number  no  longer 
defines  your  latest  file. 


2.3.2.1    Storing  a  New  Version  of  a  File  and  Using  the  Original  File  Name  — 

The  general  form  of  the  file  specification  string  to  use  when  you  want  to  store 
a  new  version  of  a  file  and  use  the  original  file  name  is  as  follows: 


input -fik'spec 


[  /  B  L  :  temporary -fiU'-sizp  ]    (fiH) 


For  the  file  specifications,  use  any  of  the  forms  that  are  valid  for  RSX  llM. 
The  options  are  described  in  Section  2.3.2.5. 

Examples:  At  the  end  of  an  editing  session  that  you  begin  with  the  following 
command,  KED  stores  a  new  version  of  the  file  named  EXAMF.FTN.  The 
new  version  includes  all  of  the  changes  made  to  the  latest  version  of 
EXAMP.FTN  under  your  default  UIC  that  KED  finds  on  the  default  system 
device. 


iiCR>KED   e;;amp.ftn   m 


[KED  displays  the  first  24  lines  of  the 
latest  version  of  SY:EXAMF.FTN 
under  vour  default  I'JC] 
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2.3.2.2  Inspecting  a  File  —  The  general  form  of  the  file  specification  strinji  to 
use  when  you  want  to  inspect  a  file  is  as  follows: 

input -fiU'spec/  I  N 

Use  any  valid  RSX-UM  file  specification.  The  /IN  option  (for  INSPECT)  is 
required. 

Examples:  When  you  begin  an  editing  session  with  the  following  command. 
KED  immediately  displays  the  first  24  lines  of  version  4  of  the  file  SY:IN- 
SPEX.PRG.  No  changes  can  be  made  to  the  file  because  the  /IN  option 
disables  all  the  keypad  editor  functions  and  commands  that  insert  or  erase 
material. 

MCR^ED     INSPE);.  PRG;a/IN    © 


2.3.2.3  Creating  an  Entirely  New  File  —  The  general  form  of  the  file  specifica- 
tion string  to  use  when  you  want  to  create  an  entirely  new  file  and  the  options 
that  the  keypad  editor  accepts  are  as  follows: 


output -filespec  /  C  R 


[  /  BL  :  temporary -file-size  I    HI) 


Use  any  valid  RSX-UM  file  specification.  The  /CR  option  (for  CREATE)  is 
required.  Th'^  other  options  are  described  in  Table  2-3. 

Examples:  At  the  end  of  an  editing  session  that  you  begin  with  the  following 
command,  KED  stores  version  1  of  a  new  file  named  EXAMP.BAS  on  the 
default  device  SY:. 


MCR>KED  EKAMP.BAS/CR  '® 


[SY:  is  the  default  output  device. 
KED  immediately  displays  the 
cursor  in  the  upper-left  corner  of  an 
empty  screen.) 


2.3.2.4   Storing  a  New  Version  of  a  File  and  Using  a  New  Output  File  Name  — 

The  general  form  of  the  file  specification  string  to  use  when  you  want  to  store 
a  new  version  of  a  file  and  use  a  new  output  file  name  is  as  follows: 


output-filespec 


[  /  B L  :  temporary  file-size ]  =  input -,'iiespec   @; 


Use  any  valid  RSX-1 
Table  2-3.    I 


IM  file  specifications.  The  options  are  described  in 
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Examples:  Assume  that  the  default  system  device  does  not  contain  a  file 
named  SPCOUT.FTN.  At  the  end  of  an  editing  session  that  you  b  }gin  with 
the  following  commands,  KED  stores  version  1  of  a  new  file  named 
SPCOUT.FTN  on  the  default  system  device.  The  file  SPCOUT.FTN;!  in- 
cludes all  of  the  changes  made  to  the  latest  version  of  (IP^NIN.FTN  that  KED 
finds  on  the  default  svstem  device. 


MCR     KED    SPCOUT.FTN  =  Gr.tUN.FTN 


2.3.2.5    Keypad  Editor  Command  Line  Options  —   Tab  ?  2-3  lists  the  options 
and  their  meanings  that  you  can  use  when  you  use  th    keypad  editor. 

Table  2-3:    Options  for  Keypad  Editor  Command  L    es 


Option 

Meaning 

/BLUemporary- file-size 

/CA 

/-CA 

/FO 

/ID 

Use  the  /BL  option  (for  BLOCKS)  and  specify  the  number  of 
blocks  that  you  want  the  keypad  editor  to  use  for  the  temporary 
file.  To  specify  a  decimal  file  size,  add  a  decimal  point  to  the 
number.  To  specify  an  octal  file  size,  omit  the  decimal  point.  The 
keypad  editor's  use  of  the  temporary  file  is  explained  in  Section 
2.3.3.2.  Since  the  default  temporary  file  size  is  usually  adequate, 
you  need  to  use  the  /BL  option  only  in  special  cases,  such  as  when 
you  want  to  combine  several  files. 

Create  the  output  file  with  the  implied  carriage  control  attribute. 
This  is  the  default  option  when  you  create  an  entirely  new  file. 

Create  the  output  file  with  the  embedded  carriage  control  at- 
tribute. 

Create  the  output  file  with  the  FORTRAN  carriage  control  at- 
tribute. However,  the  keypad  editor  does  not  check  that  the  first 
character  in  each  record  is  a  valid  FORTRAN  carriage  control 
character. 

Use  the  /ID  option  (for  IDENTIFY)  to  have  the  keypad  editor 
display  its  version  number.  Do  not  add  the  option  to  any  file 
specification  string.  The  option  is  valid  only  by  itself  in  response 
to  the  KED     and  K  52     prompts  and  in  the  following  forms  of  the 
direct  call  with  the  task  name: 

>KED/ID  m 
>K52/ID  m 

2.3.3    Restrictions  for  RSX-11iVI  Systems 

This  section  describes  the  restrictions  for  running  the  keypad  editor  on 
RSX-UM  systems. 


2.3.3.1  File,  Account,  and  Volume  Protection  —  On  RSX-UM  systems,  the 
keypad  editor  supports  the  standard  system  conventions  such  as  read,  write, 
and  update  access  to  files,  the  characteristics  of  privileged  and  non-privileged 
accounts,  and  public  and  private  devices.  The  RSX-llM/M-PLUS  MCR 
Operations  Manual  describes  these  conventions  in  detail. 
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The  keypad  editor  also  warns  you  in  the  following  cases: 

1.  When  you  specify  an  output  file  name  and  version  number  that  already 
have  been  stored  on  the  output  volume,  KED  and  KfyZ  both  display  the 
following  message: 

"^  h  E  D  -  W  -  D  Li  t  p  u  I    file   exists    -   C  o  n  t  i  ri  n  e    (  ^'  » N  i  '^ 

2.  When  you  specify  an  output  file  that  is  open  for  another  user  or  if  the 
input  and  output  file  specifications  are  the  same,  KED  and  K52  both 
display  the  following  message: 

"^KED-F-Unahle   to   create   oi.itpi.it   file 

When  the  first  message  appears,  you  can  cancel  the  editing  session  by  typing 
N  (for  no).  Or  you  can  continue  the  session,  erase  the  existing  file,  and  store 
the  new  file  that  you  create  under  the  old  name  by  typing  Y  (for  yes). 

After  the  keypad  editor  displays  the  second  message,  no  files  are  created  or 
changed.  Following  the  message,  the  system  displays  the  KED>  prompt. 

In  the  following  example,  the  keypad  editor  warns  that  disk  DM1:  already 
contains  the  file  MAYQUE.BAS;17.  It  will  be  erased  because  the  user 
responds  Y  to  the  warning. 

MCR>KED    DM1  :MAVOUE.BAS  ;i7-MAV0UE  .BAS    CREt 

'?  K  E  D  -  W  -  0  LI  t  p  i.i  t     file     exists     -     Continue     Ci'  » N  )  ^    Y    (REtl 


2.3.3.2  Output  File  and  Temporary  File  Size  —  On  RSX-llM  systems,  the 
keypad  editor  allocates  free  space  on  the  output  volume  for  two  purposes: 

1.  For  a  temporary  file  that  the  keypad  editor  uses  until  you  finish  the 
editing  session. 

2.  For  the  final  output  file  when  you  finish  the  editing  session. 

The  following  sections  describe  the  restrictions  and  requirements  that  apply 
to  the  temporary  file  and  final  file.  The  most  common  problem  occurs  when 
the  output  volume  contains  too  little  free  space  for  the  file  that  the  keypad 
editor  creates.  If  you  need  more  free  space,  you  can: 

•  Specify  an  output  volume  that  has  more  free  space  than  SY:. 

•  Create  more  free  space  on  the  SY:  volume  by  purging  some  of  the  files  that 
are  stored  there. 

•  Specify  a  smaller  temporary  file  size  by  using  the  /BL  option. 

The  keypad  editor  allows  you  to  move  the  cursor  backward  in  the  file  that  you 
are  editing,  inspecting,  or  creating.  However,  for  this  feature  the  keypad  ed- 
itor requires  a  temporary  file,  and  when  the  keypad  editor  starts,  it  allocates 
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free  space  on  the  output  volume  for  the  temporary  file.  When  you  are  creating 
an  entirely  new  file,  the  temporary  file  initially  is  empty.  When  you  are 
editing  or  inspecting  a  file,  the  keypad  editor  copies  your  RSX-llM  input  file 
into  the  temporary  file  as  you  move  the  cursor  down  through  the  file.  As  you 
back  the  cursor  up  through  the  file,  the  keypad  editor  uses  the  copy  until  you 
finish  editing. 

When  you  finish  the  editing  session,  the  keypad  editor  copies  the  temporary 
file  to  the  RSX-llM  output  file  that  you  specified.  If  the  keypad  editor 
cannot  complete  the  copying  process,  the  system  locks  both  the  output  file 
and  the  temporary  file  and  displays  the  following  message: 

?KED-F-Uriable  to  copy  temporary  file 

When  the  keypad  editor  finishes  copying,  it  truncates  the  output  file  after  the 
last  record  and  deletes  the  temporary  file.  If  the  keypad  editor  cannot  close 
the  output  file  properly,  the  system  locks  both  the  output  file  and  the  tempo- 
rary file  and  displays  the  following  message: 

?KED-F-Uriable    to    truricate    or     close    output     file 

If  either  message  appears,  the  locked  files  contain  questionable  data.  If  you 
must  try  to  salvage  part  of  either  locked  file,  use  the  PIP  UNLOCK  command 
as  described  in  the  RSX-U  Utilities  Manual. 

The  keypad  editor  allocates  free  space  on  the  output  volume  for  the  temporary 
file  and  output  file  in  one  of  the  following  ways: 

1.  When  you  are  inspecting  a  file,  the  keypad  editor  allocates  space  for  the 
temporary  file  in  the  default  UIC  and  on  the  default  system  device  SY: 
but  does  not  allocate  any  space  for  an  output  file.  The  free  space  that  the 
keypad  editor  requires  is  the  same  as  the  size  of  your  input  file.  If  the 
space  available  for  the  temporary  file  is  too  small  for  the  input  file,  the 
keypad  editor  displays  one  of  the  following  messages,  and  the  system 
displays  the  KED>  or  K52  >  prompt: 

?KED-F-Tewporary  file  shorter   thari   inpi.it   file 
?KED-F-L)riable   to  create   teriiporarv   file 

The  messages  are  explained  in  Appendix  A. 

2.  When  you  are  creating  a  new  file,  KED  normally  allocates  50  blocks  for 
the  temporary  file  and  55  blocks  for  the  output  file.  When  you  add  the  /BL 
option  to  your  file  specification  string,  the  keypad  editor  allocates  the 
amount  of  space  you  specify  for  the  temporary  file  and  10*^/  more  for  the 
output  file.  Both  spaces  are  allocated  on  the  output  volume.  When  your 
output  volume  contains  too  little  free  space,  the  keypad  editor  displays 
the  following  message  or  one  of  the  messages  listed  above,  and  the  system 
displays  the  KED>  or  K52>  prompt, 

''KED-F-Unable   to  create   output   file 
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3.  When  you  are  editinji  a  tile,  the  keypad  editor  normally  allocates  for  the 
temporary  file  50  blocks  more  than  the  size  of  your  input  file.  When  you 
add  the  /BL  option  to  your  file  specification  string,  the  keypad  editor 
allocates  the  amount  of  space  you  specify  for  the  temporary  file.  With  and 
without  the  /BL  option,  the  keypad  editor  allocates  for  the  output  file  10' i 
more  than  the  size  of  the  temporary  file.  Both  spaces  are  allocated  on  the 
output  volume.  When  your  output  volume  contains  too  little  free  space, 
the  keypad  editor  displays  one  of  the  messages  described  earlier  in  this 
section. 

When  you  start  the  keypad  editor,  if  the  temporary  file  is  not  at  least  10 
blocks  larger  than  the  input  file.  KED  and  K52  both  display  the  following 
message: 


■?KFn-'.*|-On  Iv 
(  ,   ,  tM  )  "^ 


m  III  m  III  III  (ii 


b  1  0  c  K  5     available    for     i  ri  s  e  r  l  i  o  n  s 


C  0  ri  t  1  n  u  e 


If  you  will  only  be  erasing  material  from  your  input  file  or  adding  a  small 
amount  of  new  material,  you  can  continue  the  editing  session  by  typing  Y  in 
response  to  the  message.  Otherwise,  you  can  .stop  the  session  immediately  by 
typing  N. 

When  you  add  material  to  a  file  that  you  are  creating  or  editing  and  the  file 
becomes  as  large  as  the  free  space  allocated  for  it,  the  keypad  editor  refuses  to 
accept  more  material  and  signals  you  each  time  you  try  to  insert  more.  For 
example,  if  a  file  you  are  creating  reaches  its  maximum  size  while  you  are 
typing  on  the  keyboard,  the  keypad  editor  signals  the  error  by  ringing  the  bell 
on  your  terminal  or  reversing  the  video  background  of  your  terminal's  screen. 
If  you  then  use  the  HELP  function,  the  keypad  editor  displays  the  following 
message: 


Insert     f  i  ri  d  s     file     full 


2.3.3.3  Output  File  Record  Length  —  In  the  output  file,  the  keypad  editor 
creates  a  record  for  each  text  line  in  your  file.  You  can  create  a  text  line  of  any 
length  by  typing  or  using  other  methods  of  inserting  material.  However,  when 
the  keypad  editor  copies  your  temporary  file  to  your  output  file,  the  maximum 
output  file  record  length  the  keypad  editor  creates  is  256  bytes,  not  counting 
the  record's  line  terminator.  Therefore,  if  your  temporary  file  includes  a  text 
line  that  is  longer  than  256  bytes,  the  keypad  editor  writes  more  than  one 
record  to  the  output  file.  In  this  case,  the  keypad  editor  writes  256-byte  output 
records,  adding  the  Carriage  Return  —  Linefeed  terminator,  until  256  bytes  or 
fewer  remain  in  the  temporary  file  record.  The  last  output  file  record  that  the 
keypad  editor  writes  has  the  terminator  that  the  editor  displays. 


NOTE 

The  keypad  editor  does  not  warn  you  in  this  case. 
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2.3.3.4  Input  File  Record  Length  —  When  you  are  editing  or  inspecting  a  file, 
the  s./e  of  the  keypad  editor's  input  buffer  determines  the  maximum  length  of 
input  file  records  that  the  keypad  editor  can  read.  The  following  section 
describes  how  you  can  increase  the  size  of  the  internal  input  buffer  when  you 
start  the  keypad  editor.  Whenever  an  input  file  contains  a  record  that  is  too 
long.  KED  and  K52  both  display  the  following  message  immediately  after 
starting: 


"^  K  E  D  -  W  -  I  ri  p  u  t  file  c  o  n  I  a  i  ii  s  records  that, 
C  0 1'l  I  1 1'l  1.1  e  (  'i'  I  N  )  "^ 


ill  be  t  r  u  ri  c  a  t  e  d 


When  the  message  appears,  you  can  cancel  the  editing  session  by  typing  N.  Or 
you  can  continue  the  session  by  typing  Y.  If  you  continue,  the  keypad  editor 
truncates  each  input  file  record  that  is  too  long  but  does  not  warn  you  in  any 
way. 


2.3.4    Running  the  Keypad  Editor  with  Larger  Paste  and  Input 
Buffers 

On  your  RSX-llM  system,  the  standard  size  of  the  keypad  editor's  internal 
input  buffer  and  paste  buffer  is  determined  when  KED  and  K'Yl  are  task 
built.  The  minimum  size  for  each  is  512  bytes,  but  you  can  install  the  keypad 
editor  with  a  larger  task  increment. 

You  can  increase  the  size  of  both  the  internal  input  buffer  and  the  paste  buffer 
for  a  single  editing  session  by  starting  the  keypad  editor  with  the  MCR  com- 
mand RUN,  adding  the  /INC  option  (for  INCREASE)  to  the  command  line, 
and  specifying  the  increase  in  size  thai  you  need.  The  general  forms  of  the 
RUN  command  in  this  case  are  as  follows: 


RUN    $KED/INC=.s(>p    ® 
RUN    ih52/lNC=size    '® 

Table  2-4  shows  the  number  of  words  you  need  to  specify  with  the  /INC 
option  to  increase  both  the  internal  input  buffer  and  the  paste  buffer  by 
increments  of  512  bytes.  Intermediate  increases  for  the  paste  buffer  are  also 
possible.  For  example,  when  you  specify  4400.  words  with  the  /INC  option,  the 
input  buffer  is  increased  by  512.  bytes  as  shown  in  the  table,  and  the  paste 
buffer  is  increased  by  924.  bytes  (4400.-3988.-412. +512.   924.). 

Table  2-4:    Values  for  the  /INC  Option 


Desired  increase  in 

input  and  paste  buffer  size 

Value  to  specify 
with  the  /INC  option 

512.  bytes 

1024.  bytes 

Kach  additional 
512.  bytes 

;?988.  words 
47.5B.  words 
Add  768.  words 
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2.4    Running  the  Keypad  Editor  on  RSX-11M-PLUS  Systems 

To  run  the  keypad  editor  on  RSX-llM-PLUS  systems,  use  the  same  proce- 
dures as  for  RSX-llM.  The  keypad  editor  accepts  all  valid  RSX-llM-PLUS 
file  specifications. 

In  addition  to  the  RUN  command  and  the  direct  calls  with  the  task  names 
KED  and  K52,  you  can  run  KED  and  K52  with  the  RSX-llM-PLUS  EDIT 
command.  Complete  the  EDIT  command  with  the  A'SINCi  qualifier  and  add 
the  task  name  KED  or  K52.  For  example,  to  use  KED  to  inspect  a  file  named 
STUDY.TST  that  is  on  the  default  system  device,  type  the  following  EDIT 
command: 

>EDIT/USING:KED  STUDY. TST/IN  ® 


2.5    Stopping  the  Keypad  Editor 

To  stop  a  keypad  editor  session,  use  the  COMMAND  function  and  the  EXIT 
or  QUIT  command.  You  can  stop  a  session  while  any  part  of  a  file  is  on  your 
screen.  You  do  not  need  to  move  the  cursor  to  any  special  locations  in  a  file  to 
stop. 


NOTE 

Refer  to  a  copy  of  the  keypad  diagram  for  the  VTIOO  or  VT52 
when  you  are  learning  the  following  commands  and  functions. 
See  Figure  1-1  and  1-2  for  the  keypad  diagrams. 

2.5.1    The  COMMAND  Function 

VTlOO  Keys:  The  PFl  key,  then  the  7  key  on  the  keypad. 
VT52  Keys:    The  blue  key,  then  the  7  key  on  the  keypad. 

To  use  any  keypad  editor  command,  press  the  GOLD  key  and  then  the  COM- 
MAND key.  When  you  use  the  COMMAND  function,  the  keypad  editor  tem- 
porarily erases  the  top  two  lines  of  your  screen  and  displays  the  prompt 
C  0  fn  m  a  i"i  d : . 

The  keypad  editor  accepts  several  different  commands.  (Most  are  presented 
later  in  this  section.)  To  complete  a  command:. 

•  Type  the  command  name  in  full  or  use  an  abbreviation. 

•  Terminate  the  command  with  the  ENTER  function  (press  the  Enter  key  on 
the  keypad). 

The  following  sections  show  complete  procedures  for  using  the  EXIT  and 
QUIT  commands  to  stop  the  keypad  editor. 


2-20       Starting  and  Stopping  the  Keypad  Editor 


2.5.2    The  EXIT  Command 

The  full  tbrm  ot  the  KXIT  command  is  as  follows.  The  keypad  editor  does  not 
accept  any  abbreviation. 

e;;it 

When  you  use  the  KXTI'  command  to  stop  an  editing  session,  the  keypad 
editor  completes  the  following  steps. 

1.  The  keypad  editor  closes  all  files. 

2.  The  keypad  editor  creates  or  renames  files,  if  necessary. 

:].  If  you  have  been  editing  or  creating  a  file,  the  keypad  editor  saves  the 
results  of  your  work,  including  an  open  auxiliary  output  file. 

4.  The  keypad  editor  then  displays  the  prompt  you  see  when  you  start  any 
editing  session.  Therefore,  you  can  immediately  start  another  .session  by 
typing  another  file  specification  string. 


2.5.3    The  QUIT  Command 

The  full  form  of  the  QUIT  command  is  as  follows.  The  keypad  editor  does  not 
accept  any  abbreviation. 

QUIT 

When  you  use  the  QUIT  command  to  stop  an  editing  session,  the  keypad 
editor  completes  the  following  steps. 

1.  The  keypad  editor  closes  all  input  files  without  changing  then  in  any  way. 

2.  The  keypad  editor  purges  your  main  output  file  (and  auxiliary  output  file, 
if  one  is  open).  "Purge"  means  that  the  temporary  output  file  and  the 
main  output  file  are  not  preserved.  The  keypad  editor  displays  the  mes- 
sage 

'?  K  E  D  -  W  -  0  I.I  t  p  u  t   files  pureed. 

3.  The  keypad  editor  then  displays  the  s^^me  prompt  that  you  see  when  you 
start  an  editing  session.  Therefore,  you  can  immediately  start  another 
session  by  typing  another  file  specification  string. 
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The  principal  differences  between  using  the  EDIT  command  and  the  RUN  or 
R  command  are  in  how  you  return  to  "he  RT-U  monitor  level  and  whether 
special  settings  you  have  made  while  using  the  keypad  editor  are  preserved 
when  you  finish  an  editing  session. 

When  you  use  the  EDIT  command,  the  keypad  editor  returns  you  to  the 
RT-11  monitor  level  and  displays  the  monitor  prompt  ( . )  when  you  finish  an 
editing  session.  Any  special  settings  that  you  have  made  while  editing  and 
anything  that  you  have  stcred  in  the  keypad  editor  s  buffers,  such  as  the  paste 
buffer,  are  lost. 
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2.3.3.4  Input  File  Record  Length  —  When  you  are  editing  or  inspecting  a  file, 
the  size  of  the  keypad  editor's  input  buffer  determines  the  maximum  length  of 
input  file  records  that  the  keypad  editor  can  read.  The  following  section 
describes  how  you  can  increase  the  size  of  the  internal  input  buffer  when  you 
start  the  keypad  editor.  Whenever  an  input  file  contains  a  record  that  is  too 
long,  KED  and  K52  both  display  the  following  message  immediately  after 
starting: 


"^ K E D -  W -  I  n  p u  t  file  c  o ri  t  a  i  n  s  records  that  will  be 
C  0  n  t  1  ri  u  e  (Y.N)'' 


truncated  - 


When  the  message  appears,  you  can  cancel  the  editing  session  by  typing  N.  Or 
you  can  continue  the  session  by  typing  Y.  If  you  continue,  the  keypad  editor 
truncates  each  input  file  record  that  is  too  long  but  does  not  warn  you  in  any 
way. 


2.3.4    Running  the  Keypad  Editor  with  Larger  Paste  and  input 
Buffers 

On  your  RSX-llM  system,  the  standard  size  of  the  keypad  editor's  internal 
input  buffer  and  paste  buffer  is  determined  when  KED  and  K52  are  task 
built.  The  minimum  size  for  each  is  512  bytes,  but  you  can  install  the  keypad 
editor  with  a  larger  task  increment. 

You  can  increase  the  size  of  both  the  internal  input  buffer  and  the  paste  buffer 
for  a  single  editing  session  by  starting  the  keypad  editor  with  the  MCR  com- 
mand RUN,  adding  the  /INC  option  (for  INCREASE)  to  the  command  line, 
and  specifying  the  increase  in  size  that  you  need.  The  general  forms  of  the 
RUN  command  in  this  case  are  as  follows: 


RUN    $KED/INC=.'?i2e    m 
RUN    %K52/ lUC  =  size    m 

Table  2-4  shows  the  number  of  words  you  need  to  specify  with  the  /INC 
option  to  increase  both  the  internal  input  buffer  and  the  paste  buffer  by 
increments  of  512  bytes.  Intermediate  increases  for  the  paste  buffer  are  also 
possible.  For  example,  when  you  specify  4400.  words  with  the  /INC  option,  the 
input  buffer  is  increased  by  512.  bytes  as  shown  in  the  table,  and  the  paste 
buffer  is  increased  by  924.  bytes  (4400. -3988.=412. +512.-924.). 

Table  2-4:    Values  for  the  /INC  Option 


Desired  increase  in 

input  and  paste  buffer  size 

Value  to  specify 
with  the  /INC  option 

512.  bytes 

1024.  bytes 

Each  additional 
512.  bytes 

.S988.  words 
4756.  words 
Add  768.  words 
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2.4  Running  the  Keypad  Editor  on  RSX-11M-PLUS  Systems 

To  run  the  keypad  editor  on  RSX-UM-PLUS  systems,  use  the  same  proce- 
dures as  for  RSX-llM.  The  keypad  editor  accepts  all  valid  RSX-llM-PLUS 
file  specifications. 

In  addition  to  the  RUN  command  and  the  direct  calls  with  the  task  names 
KED  and  K52.  you  can  run  KED  and  K52  with  the  RSX-llM-PLUS  EDIT 
command.  Complete  the  EDIT  command  with  the  /USING  qualifier  and  add 
the  task  name  KED  or  K52.  For  example,  to  use  KED  to  inspect  a  file  named 
STUDY.TST  that  is  on  the  default  system  device,  type  the  following  EDIT 
command: 

>EDIT/USING:KED  STUDY. TST/IN  ® 

2.5  Running  the  Keypad  Editor  on  IAS  Systems 

You  can  run  the  keypad  editor  on  IAS  systems  in  two  ways: 

1.  Using  the  Monitor  Console  Routine  (MCR).  You  call  the  keypad  editor 
directly  with  the  task  names  KED  or  K52. 

2.  Using  the  DEC  Command  Language  (DCL)  implemented  on  IAS  by  the 
Program  Development  System  (PDS).  You  use  the  PDS  command 
EDIT/KED  or  EDIT/K52. 

With  MCR,  if  you  call  the  keypad  editor  directly,  including  a  file  specification 
string  in  the  call,  the  keypad  editor  returns  you  to  MCR  when  you  finish  an 
editing  session.  Any  special  settings  that  you  made  while  using  the  keypad 
editor  and  anything  thai  you  stored  in  the  keypad  editor's  buffers,  such  as  the 
paste  buffer,  are  lost. 

MCR  users  can  also  call  the  keypad  editor  directly  without  including  a  file 
specification  string.  In  this  case,  the  special  settings  that  you  made  and  the 
contents  of  the  keypad  editor's  buffers  are  preserved  for  your  next  keypad 
editor  session.  When  the  prompt  KED>  is  displayed,  you  can  start  a  keypad 
editor  session  by  completing  a  keypad  editor  file  specification  string,  or  you 
can  return  to  MCR  level  by  typing  CTRL/Z.  The  settings  and  buffer  contents 
are  lost  only  when  you  respond  to  the  prompt  KED>  by  typing  CTRL/Z  or 
when  you  exit  from  the  keypad  editor  in  any  way. 

With  DCL  (PDS),  the  keypad  editor  returns  you  to  PDS  when  you  finish  an 
editing  session.  Any  special  settings  that  you  made  while  using  the  keypad 
editor  and  anything  that  you  stored  in  the  keypad  editor's  buffers,  such  as  the 
paste  buffer,  are  lost. 

The  following  sections  describe  the  different  methods  of  running  the  keypad 

editor. 

For  a  full  description  of  MCR,  see  the  IAS  MCR  User's  Guide. 
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2.5.1    Start-up  Default  Values  Under  IAS 

Table  2-5  summarizes  the  command  default  values  for  the  keypad  editor 
running  under  IAS. 

Table  2-5:    Start-up  Default  Values  Under  IAS 


Item 


Device  name 


UFD 


Input  file 
name  and  type 

Output  file 
name  and  type 


Input  file 
version 

Output  file 
version 


Output  file 
protection 


Output  file 

carriage 

control  attribute 

Size  of  the 
temporary  file 


Default 


Your  system  device  when  you  log  in.  You  can  change 
your  default  device  subsequently  on  a  timesharing 
system  by  using  the  PDS  SET  DEFAULT  command. 
On  a  multi-user  system  you  cannot  specify  a  default 
device. 

The  default  IIFD  is  equivalent  to  vour  UIC  when  log- 
ging in.  Use  the  PDS  SET  DEFAULT  command  to 
specify  a  different  default  UFD.  or  the  MCR  SET 
UIC  command  to  specify  a  different  UIC. 

No  default.  You  must  specify  the  file  name  and  type. 


When  creating  a  new  file  from  an  existing  file,  you 
must  specify  the  output  file  name  and  type.  When 
creating  a  new  version  of  a  file,  the  keypad  editor  uses 
the  input  file  name  and  type. 

The  latest  version  of  the  input  file. 


When  creating  a  new  file,  the  keypad  editor  assigns 
version  L  Otherwise,  the  keypad  editor  assigns  a  ver- 
sion number  that  is  1  greater  than  the  version  num- 
ber of  the  latest  version. 

When  creating  a  new  file,  the  system  gives  the  file  the 
default  file  protection  of  the  volume.  When  editing  a 
file,  the  keypad  editor  .sets  the  output  file  protection 
to  match  the  input  file  protection.  To  change  the  file 
protection,  use  the  PDS  SET  PROTECTION  com- 
mand or  the  PIP  utility  with  the  /PR  switch.  See  the 
M.S'  PDS  I'ser's  Guide  and  the  IAS  L'tilities  Manual 
respectively. 

When  creating  a  new  file,  the  keypad  editor  assigns 
the  implied  carriage  control  attribute.  Otherwise,  the 
keypad  editor  assigns  the  input  file's  attribute. 

The  size  of  the  temporary  file  limits  the  amount  by 
which  you  can  increa.se  the  size  of  the  input  file  in  one 
keypad  editor  session.  When  you  create  a  new  file,  the 
default  size  of  the  temporary  file  is  ."lO  blocks.  Other- 
wise, the  default  size  is  50  blocks  larger  than  the  in- 
put file. 
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2.5.2  Calling  the  Keypad  Editor  with  the  Task  Names  KED  and 
K52 

If  you  have  a  real-time  system,  or  a  multi-user  system  with  MCR  as  the  user 
interface,  you  can  call  the  keypad  editor  directly  by  typing  the  task  name. 

The  two  forms  of  the  call,  which  are  the  same  as  for  RSX-llM.  are  described 
in  Section  2.3.2. 

2.5.3  Using  the  DCL  EDIT/KED  or  EDIT/K52  Command 

The  DCL  (PDS)  command  EDIT  allows  you  to  use  DIGITAL'S  text  editors. 
The  IAS  PDS  User's  Guide  describes  the  P'.DIT  command  in  full.  The  follow- 
ing sections  describe  how  to  specify  the  command  so  that  you  can  use  the 
keypad  editor. 

You  use  KDIT/KED  if  you  are  running  the  keypad  editor  on  a  VTIOO  termi- 
nal, or  EDIT/K52  if  you  are  running  the  keypad  editor  on  a  VT'vi  termmal. 
The  command  format  is  as  follows: 

PDS  )     E  D  I  T  /  K  E  D  [  /  q  iJ  a  1  5  ]     i  n  f  i  1  e  s  p  e  c     (RET) 


or 


PDS.     E  D  I  T  /  K  5  2  [  /  q  Li  a  1  5  ]     i  n  f  i  1  e  s  p  e  c     (REJ 

where  /quals  are: 
/BLOCK_SIZE:n 


/EMBEDDED_CARRIAGE_CONTROL 


/FORTRAN_CARRIAGE_CONTROL 


Specifies  the  number  of  blocks 
(n)  that  the  keypad  editor  is  to 
use  for  the  temporary  file,  n  is 
always  decimal.  No  decimal 
point  is  permitted. 

The  keypad  editor's  use  of  the 
temporary  file  is  explained  in 
Section  2.5.4.2.  Becau.se  the  de- 
fault temporary  file  size  is  usu- 
ally adequate,  you  need  to  use 
the  /BLOCK_SIZE:n  qualifier 
only  in  special  cases,  for  exam- 
ple, when  you  want  to  combine 
several  files. 

Creates  the  output  file  with  the 
embedded  carriage  control  at- 
tribute. 

Creates  the  output  file  with  the 
FORTRAN  carriage  control  at- 
tribute. However,  the  keypad 
editor  does  not  check  that  the 
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ampli?:d_carriage_control 


/INSPECT 


/OUTPlT:Outlilespec 
inl'ilespec 


first  character  in  each  record  is 
a  valid  FORTRAN  carriage 
control  character. 

Creates  the  output  tile  with  the 
carriage  control  attribute.  This 
is  the  default  when  you  create  a 
new  file. 

Allows  vou  to  inspect  the  input 
file.  When  ANSPECT  is  used, 
you  cannot  specify  any  other 
qualifiers. 

Outfilespec  is  the  output  file. 
Is  the  input  file. 


The  qualifiers  that  you  specify  to  the  EDIT/KED  or  EDn7K52  command 
start  one  of  the  four  keypad  editor  editing  processes: 

1.  Storing  a  new  version  of  a  file,  and  using  the  original  file  name 

2.  Inspecting  a  file 

3.  Creating  a  file 

4.  Storing  a  new  version  of  a  file,  and  using  a  new  output  file  name 

The  different  forms  of  the  EDIT/KED  or  EDIT/K52  command  that  you  spec- 
ify to  start  each  editing  process  are  described  in  Sections  2.5.3.1  to  2.5.3.4. 

NOTE 

By  default,  IAS  systems  use  the  input  file  with  the  highest 
version  number  and  store  the  output  file  with  the  next  highest 
version  number. 

Although  the  system  and  the  keypad  editor  accept  an  explicit 
output  file  version  number,  by  using  such  a  number  you  may 
accidentally  reduce  the  security  of  your  files.  For  example,  if 
you  specify  an  output  file  version  number  that  is  lower  than  the 
version  number  of  your  input  file,  the  highest  version  number 
no  longer  defines  your  latest  file. 

2.5.3.1    Storing  a  New  Version  of  a  File  and  Using  the  Original  File  Name  —  To 

store  a  new  version  of  a  file  and  use  the  criginai  file  name,  use  one  of  the 
following  formats: 

P  D  5       E  D  I  T  /  K  E  D  [  /  q  u  a  1  5  ]     i  ri  f  i  1  e  s  p  e  c    ,r.cD 


or 


P  D  S       E  D  I  T  /  K  5  2  [  /  =1  u  a  1  s  ]     i  n  f  i  1  e  s  p  e  c    ® 
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where 

/qvials  are  one  or  more  of  the  followirifj: 

/BL0CK5-SIZE:n 
/EMBEDDED.CArvRIA  JE_  CONiryOL 
/FOrviryAN.CAryRIAGE-CONTryOL 
/  IMPL  IED_CAryryI  AGE-CONTROL 


The  quaHt'iers  are  described  in  Section  2.").;?.  I'se  any  valid  IAS  tile  spec  ifica- 
tion  tor  int'iles|)ec. 

Example: 

At  the  end  ol  an  editing  session  that  you  begin  with  the  following  command. 
KKD  stores  a  new  version  of  the  file  named  .IKN.LST.  The  new  version 
includes  all  the  changes  made  to  the  latest  version  of  -IKN.LST  under  your 
ITT)  on  your  default  device. 

PDS>  EDrr/KP:D  JEX.LST    IKKI)  displays  the  first  24  lines  of  the  latest 

version  of  .IKN.LST). 


2.5.3.2   Inspecting  a  File —  To  inspect  a  file,  use  one  of  the  following  formats: 


PDS   EDIT/KED/ INSPECT  infilespec  (RED 


or 


PDS       EDIT/K52/ INSPECT     i  n f i 1 e s p e c     fm 


The  /INSPECT  qualifier  is  described  in  Section  2.5.3. 

Example: 

When  you  begin  an  editing  session  with  the  following  command.  K52  immedi- 
ately displays  the  first  24  lines  of  the  most  recent  version  of  the  file  IN 
SPEX.FTN.  You  cannot  make  any  changes  to  the  file  because  the  /INSPECT 
qualifier  disables  all  the  keypad  editor  functions  or  commands  that  insert  or 
erase  material. 


PDS   EDIT/K52/ INSPECT  INSPEK.FTN 

2.5.3.3    Creating  a  New  File  —   To  create  a  new  file,  use  one  of  the  following 
formats: 

PDS       EDIT/KED/OUTPUT:  O'.tt  f  1  1  psppcC /qi.ial  5  ]     ® 


or 
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PDS   EDIT/K52/0UTPUT:  out  f  1  lespecC /qual  s  ]  (rH) 
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where 

/quals  are  one  or  more  of  the  following: 

/BLOCK_SIZE:n 

/EMBEDDED. .CARRIAGE -CONTROL 
/FORTRAN -CARRIAGE -CONTROL 
/ I MPL I  ED -CARRIAGE-CONTROL 

The  file  qualifiers  are  described  in  Section  2.5.3.  Use  any  valid  IAS  file  speci- 
fication for  outfilespec. 

Example: 

At  the  end  of  an  editing  session  that  you  begin  with  the  following  command, 
KED  stores  version  1  of  a  new  file  named  JW123.CBL  under  your  UFD  on 
vour  default  device. 


PDS>  EDIT/KED/OUTPUT:  JW123.C6L  ©    [KED  immediately  displays 

the  cursor  in  the  upper-left 
corner  of  an  empty  screen). 

2.5.3.4   Storing  a  New  Version  of  a  File  and  Using  a  New  Output  File  Name  — 

To  store  a  new  version  of  a  file  and  use  a  new  output  file  name,  use  one  of  the 
following  formats: 

PDS-    EDIT/KED/OUTPUT  :  OLitf  1  1  espec  [ /qi-ial  5  ]  irif  1  1  espec    (H) 


or 

PDS>  EDIT/K52/0UTPUT:  outfilespecC/'iualslinfilespec 

where 

/quals  are  one  or  more  of  the  following: 

/BLOCK_SIZE:n 

/EMBEDDED-CARRIAGE-CONTROL 
/FORTRAN-CARRIAGE-CONTROL 
/  I  MPL I  ED-CARRIAGE-CONTROL 

The  qualifiers  are  described  in  Section  2.5.3.  Use  any  valid  IAS  file  specifica- 
tions for  outfilespec  and  infilespec. 

Example: 

Assume  that  your  default  device  does  not  contain  a  file  named  EXAMP.FTN. 
At  the  end  of  an  editing  session  that  you  begin  with  the  following  command, 
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KED  stores  version  1  of  a  new  file  named  P^XAMP.FTN  under  your  UFI)  on 
your  default  device.  The  file  EXAMF.PTN  includes  all  chanjjes  made  to  the 
latest  version  of  the  file  OLDP:X.FTN  that  KED  finds  under  your  UFI)  on 
vour  default  device. 


FDS       EDIT/KED/OUTPUT  :E;;AMP.FTN    0LDE;;.FTN    (RET) 

2.5.4    Restrictions  for  IAS  Systems 

This  section  descrihes  the  restrictions  for  running  the  keypad  editor  on  IAS 
systems. 

2.5.4.1  File  and  Volume  Protection  —  On  IAS  systems,  the  keypad  editor 
supports  the  standard  system  conventions,  such  as  read,  write,  and  update 
access  to  files.  The  IAS  PDS  User's  Uuidr  and  the  IAS  MCR  User's  Caiide 
describe  file  and  volume  protection  in  detail. 

The  keypad  editor  also  warns  you  in  the  following  cases: 

1.  When  you  specify  an  output  file  name  and  version  number  that  have 
already  been  stored  on  the  device  you  specify,  KED  and  K52  both  display 
the  following  message: 

•^  K  E  D  -  W  -  0  LI  t  p  u  t     file     exists     -     Continue     (  Y  .  N  )  "? 

2.  When  you  specify  an  output  file  that  is  open  for  another  user,  or  if  the 
input  and  output  file  specifications  are  the  same.  KED  and  K52  both 
display  the  following  message: 

?  K  E  D  -  F  -  L)  i-i  a  h  1  e     to     create     output     file 

When  the  first  message  appears  you  can  cancel  the  editing  session  by  typing 
N  (for  no).  Or  you  can  continue  the  session,  erase  the  existing  file,  and  store 
the  new  file  that  you  create  under  the  old  name  by  typing  Y  (for  yes). 

After  the  keypad  editor  displays  the  second  message,  no  files  are  created  or 
changed.  Following  the  message,  the  system  displays  either  the  system 
prompt  or  the  KED  prompt,  depending  on  how  you  invoked  the  keypad  edi- 
tor. 

In  the  following  example,  the  keypad  editor  warns  that  disk  DM1:  already 
contains  the  file  MAYQUE.BAS;17.  It  will  be  erased  because  you  respond  Y 
to  the  warning. 

MCR/KED  DM1  :MAYOUE  .SAS  ;  17:^Mhi'0UE.BAS  (RET! 

■^  K  E  D  -  W  -  0  u  t  p  u  t  file  exists  -  C  o  n  t  i  n  i.i  e  (  Y  ,  N  )  '^    Y  ® 

or 


PDS>  EDIT/KED/0UTPUT:DM1 :MAYQUE .BAS i 17  MAYOUE.BAS  W) 
'^KED-W-OutP  u  t  file  exists  -  Continue  <  Y  t  N  )  "^  Y  (H) 
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2.5.4.2  Output  File  and  Temporary  File  Size  —  On  IAS  systems,  the  keypad 
editor  allocates  free  space,  on  the  device  that  you  specify  to  contain  the 
output  file,  for  two  purposes: 


1.  For  a  temporary  file  that  the  keypad  editor  uses  until  you  finish  the 
editing  session. 

2.  For  the  final  output  file  when  you  finish  the  editing  sessi(m. 

The  following  sections  describe  the  restrictions  and  requirements  that  apply 
to  the  temporary  file  and  final  file.  The  most  common  problem  occurs  when 
the  device  that  you  specify  to  contain  the  output  file  contains  insufficient  free 
space  for  the  file  that  the  keypad  editor  creates.  If  you  need  more  free  space, 
you  can: 

•  Specify  a  disk  with  more  free  space  on  it  to  contain  the  output  file. 

•  Free  some  space  on  the  device  that  you  specified  by  purging  some  of  the  files 
that  are  stored  there. 

•  Specify  a  smaller  temporarv  file  size  bv  using  the  /BL  switch  (MCR)  or  the 
/BLOCK_SIZE:n  qualifier  to  EDIT/KED  or  EDIT/K52  (DCL). 

The  keypad  editor  allows  you  to  move  the  cursor  backward  in  the  file  that  you 
are  editing,  inspecting,  or  creating.  For  this  feature  the  keypad  editor  requires 
a  temporary  file,  and  when  the  keypad  editor  starts,  it  allocates  fr  space  for 
the  temporary  file.  When  you  are  creating  a  new  file,  the  temporary  file 
initially  is  empty.  When  you  are  editing  or  inspecting  a  file,  the  keypad  editor 
copies  your  input  file  into  the  temporary  file  as  you  move  the  cursor  down 
through  the  file.  As  you  move  the  cursor  backward  through  the  file,  the  key- 
pad editor  uses  the  copy  until  you  finish  editing. 

When  you  finish  the  editing  session,  the  keypad  editor  copies  the  temporary 
file  to  the  output  file  that  you  specified.  If  the  keypad  editor  cannot  complete 
the  copying  process,  the  system  locks  both  the  output  file  and  the  temporary 
file  (named  KEDXXX.TMP),  and  displays  the  following  message: 

■^  K  E  D  -  F  -  U  ri  a  b  1  e    to    copy    temporary     file 

When  the  keypad  editor  finishes  copying,  it  truncates  the  output  file  after  le 
last  record  and  deletes  the  temporary  file.  If  the  keypad  editor  cannot  close 
the  output  file  correctly,  the  system  locks  both  the  output  file  and  the  tempo- 
rary file  and  displays  the  following  message: 


?  K  E  D  -  F  -  U  ri  a  ti  1  e  to  truncate  or  close  output  file 

If  either  message  appears,  the  locked  files  contain  questionable  data.  If  you 
must  try  to  salvage  part  of  either  locked  file,  use  the  PIP  UNLOCK  com- 
mand, described  in  the  IAS  Utilities  Manual  or  the  PDS  commands  UN- 
LOCK and  SET  END-OF-FILE,  described  in  the  IAS  PDS  User's  Guide. 
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The  keypad  editor  allocates  free  space  for  both  the  temporary  file  and  output 
file  in  one  of  the  following  ways: 

1.  When  you  are  inspecting  a  file,  the  keypad  editor  allocates  space  for  the 
temporary  file  in  your  default  UFD  and  on  your  default  device  but  does 
not  allocate  any  space  for  an  output  file.  The  free  space  that  the  keypad 
editor  requires  is  the  same  as  the  size  of  your  input  file.  If  the  space 
available  for  the  temporary  file  is  too  small  for  the  input  file,  the  keypad 
editor  displays  the  following  message,  and  the  system  displays  the  KED> 
or  K52>  prompt: 


?KED-F-Unable  to  create  temporary  file 


The  messages  are  explained  in  the  Appendix. 

2.  When  you  are  creating  a  new  file,  KED  normally  allocates  50  blocks  for 
the  temporary  file  and  55  blocks  for  the  output  file.  When  you  add  the  /BL 
option  to  your  file  specification  string  (MCR),  or  the  BLOCK_SIZE:n  file 
qualifier  to  the  EDIT/KED  or  EDIT/K52  command  (DCL),  the  keypad 
editor  allocates  the  amount  of  space  you  specify  for  the  temporary  file  and 
10%  more  for  the  output  file.  Both  spaces  are  allocated  on  the  device  that 
you  specify  to  contain  the  output  file.  When  this  device  contains  insuffi- 
cient free  space,  the  keypad  editor  displays  the  following  message  or  one  of 
the  messages  listed  above,  and  the  system  displays  the  KED>  or  K52> 
prompt. 

?KED-F-Uriable    to    create    oijtpul    file 


3.  When  you  are  editing  a  file,  the  keypad  editor  normally  allocates  for  the 
temporary  file  50  blocks  more  than  the  size  of  your  input  file.  When  you 
add  the  /BL  option  to  your  file  specification  string  (MCR),  or  the 
BLOCK_SIZE:n  file  qualifier  to  the  EDIT/KED  or  EDIT/K52  command, 
the  keypad  editor  allocates  the  amount  of  space  you  specify  for  the  tempo- 
rary file.  With  and  without  the  /BL  option  (MCR),  or  the  BLOCK_ 
SIZE:n  file  qualifier  to  the  EDIT/KED  or  EDIT/K52  command  (DCL). 
the  keypad  editor  allocates  for  the  output  file  10  percent  more  than  the 
size  of  the  temporary  file.  Both  spaces  are  allocated  on  the  device  that  you 
specify  to  contain  the  output  file.  When  this  device  contains  insufficient 
free  space,  the  keypad  editor  displays  one  of  the  messages  described  ear- 
lier in  this  section. 

When  you  start  the  keypad  editor,  if  the  temporary  file  is  not  at  least  ten 
blocks  larger  than  the  input  file,  KED  and  K52  both  display  the  following 
message: 


?KED-W- 
(Y  >N)? 


Oril 


XKXKXK  blocks  3  Mailable  for  insertions 


C  0  ri  t  i  n  u  e 


If  you  are  only  deleting  material  from  your  input  file  or  adding  a  small 
amount  of  new  material,  you  can  continue  the  editing  session  by  typing  Y  in 
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response  to  the  message.  Otherwise,  you  can  stop  the  session  immediately  by 
typing  N. 

When  you  add  material  to  a  file  that  you  are  creating  or  editing,  and  the  file 
becomes  as  large  as  the  free  space  allocated  for  it,  the  keypad  editor  refuses  to 
accept  more  material  and  signals  you  each  time  you  try  to  insert  more.  For 
example,  if  a  file  you  are  creating  reaches  its  maximum  size  while  you  are 
typing  on  the  keyboard,  the  keypad  editor  signals  the  error  by  ringing  the  bell 
on  your  terminal  or  reversing  the  video  background  of  your  terminal's  screen. 
If  you  then  use  the  HELP  function,  the  keypad  editor  displays  the  following 
message: 


Insert     f  i  r.  d  5    file    f  li  1  1 

2.5.4.3  Output  File  Record  Length  —  In  the  output  file,  the  keypad  editor 
creates  a  record  for  each  text  line  in  your  file.  You  can  create  a  text  line  of  any 
length  by  typing  or  using  other  methods  of  inserting  material.  However,  when 
the  keypad  editor  copies  your  temporary  file  to  your  output  file,  the  maximum 
output  file  record  length  that  the  keypad  editor  creates  is  256  bytes,  not 
counting  the  record's  line  terminator.  Therefore,  if  your  temporary  file  in- 
cludes a  text  line  that  is  longer  than  256  bytes,  the  keypad  editor  writes  more 
than  one  record  to  the  output  file.  In  this  case,  the  keypad  editor  writes  256- 
byte  output  records,  adding  the  Carriage  Return  -  Linefeed  terminator,  until 
256  bytes  or  fewer  remain  in  the  temporary  file  record.  The  last  output  file 
record  that  the  keypad  editor  writes  has  the  terminator  that  the  editor  dis- 
plays. 

NOTE 

The  keypad  editor  does  not  warn  you  when  it  has  handled  long 
records  as  described  above. 


2.5.4.4  Input  File  Record  Length  —  When  you  are  editing  or  inspecting  a  file, 
the  size  of  the  keypad  editor's  input  buffer  determines  the  maximum  length  of 
input  file  records  that  the  keypad  editor  can  read.  The  following  section 
describes  how  you  can  increase  the  size  of  the  internal  input  buffer  when  you 
start  the  keypad  editor.  Whenever  an  input  file  contains  a  record  that  is  too 
long,  KED  and  K52  both  display  the  following  message  immediately  after 
starting: 


"^  K  E  D  -  W  -  I  »-i  p  iJ  t  file  c  0  ri  t  a  1  ri  5  records  that  1*1 1  1  1  t.  e  t  r  i.n"!  c  a  t  e  ^i  - 
C  0  ri  t  1  vi  u  e  (  '1'  I  N  )  "^ 

When  the  messsage  appears,  you  can  cancel  the  editing  session  by  typing  N. 
Typing  Y  continues  the  session.  If  you  continue,  the  keypad  editor  truncates 
each  input  file  record  that  is  too  long  but  does  not  warn  you  in  any  way. 
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2.5.5    Running  the  Keypad  Editor  with  Larger  Paste  and  Input 
Buffers 

On  your  IAS  system,  the  standard  size  of  the  keypad  editor's  internal  input 
huffer  and  paste  hulTer  is  determined  when  KKI)  and  KoL'  are  task  huih.  The 
minimum  si/e  tor  each  is  512  bytes,  hut  you  can  install  the  keypad  input 
editor  with  a  larger  task  increment. 

You  can  increase  the  size  of  both  the  internal  input  buffer  and  the  paste  buffer 
for  a  single  editing  session  by  starting  the  keypad  echtor  with  the  MCR  or 
DCL  (in)S)  command  Hl'N.  adding  the  /INT  option  (for  INCRKASK)  or 
/INCRP^ASE  qualifier  to  the  command  line,  and  specitying  the  increase  in  size 
that  vou  need.  The  forms  of  the  RUN  command  in  this  case  are  as  follows: 


MCry  RUN  [  1  1  .1  ]KED/ INC  =  s  1  ze  'Mfi 
MCry  RUN  [  1  1  .  1]K52/ INC  =  5  1  re  Rtf 


or 


PDS   RUN/ INCREASE.— .  1  ze  [ll-llKED  REfi 
PDS   RUN/ INCREASE  :  s  1  ze  [ll.l]h5Z  RET: 

Table  2  (5  shows  the  number  ot  words  you  need  to  specify  with  the  /IXC 
option  or  /IXCRKASK  qualifier  to  increase  both  the  internal  input  l)uffer  and 
the  paste  buffer  by  increments  ot  r)12  b\tes.  Intermediate  increases  tor  the 
paste  buffer  are  also  possible.  For  example,  when  you  specify  4400.  words  with 
the  /IXC  option  or  /IXCRF'ASF.  qualifier,  the  input  buffer  is  increased  by  n\'2. 
bytes  as  shown  in  the  table,  and  the  paste  buffer  is  increased  by  924.  bytes 
(4400.-;598H.    412.. 512.    924). 

Table  2-fi:    Values  for  the  /INC  Option  and  /INCREASE  Qualifier 


Desired  increase  in 

input  and  paste  buffer  size 

Value  to  specify 
with  the  /INC  option 

512.  bytes 

lO'Jt.  hvles 

Kac'hi  additKinnl  'il'I.  l)yte,s 

:i9HH.  words 
4T")(k  woriis 
.\(\(\  TtiH.  words 

2.6    Stopping  the  Keypad  Editor 

To  stop  a  keypad  editor  ses-iion.  use  the  COMMAXI)  function  and  the  P'AIT 
or  (^CIT  command.  You  can  stop  a  session  while  any  part  ol  a  file  is  on  your 
screen.  You  do  not  need  to  move  the  cursor  to  any  special  locations  in  a  tile  to 
stop. 

NOTE 

Refer  to  a  copy  of  the  keypad  diagram  tor  the  \'T100  or  \'Trv2 
when  you  are  learning  the  following  commands  and  tumtions. 
See  Figure  1-1  and  1-2  for  the  keypad  diagrams. 
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2.6.1    The  COMMAND  Function 

VrUM)  Keys:  The  PKl  key.  then  the  7  kev  on  the  keypad. 
\"r')2  Keys:     The  hlue  key.  then  the  7  key  >tn  the  keypad. 

Id  vise  any  keypad  editor  conmiand.  press  (he  (iOLD  key  and  then  the  COM- 
MA.NI)  key.  When  you  use  the  COMMAND  luiution.  the  keypad  editor  tem- 
porarily erases  the  top  two  hues  o|  your  screen  and  displays  the  prompt 
C  0  (II  III  a  I'l  d : . 

The  keypad  editor  accepts  several  ditlerent  lommands.  (MonI  are  presented 
later  in  this  seition.i  To  complete  a  command:. 

•  Type  the  command  name  \n  lull  or  use  an  ahbrevuition. 

•  Terminate  the  command  with  the  KN"IT-l-{  function  (press  the  Knter  key  on 
the  key[)ad). 

The  tollowin^'  sections  show  complete  procedures  lor  using  the  KXl'I"  and 
(^iri'  commancls  to  .stop  the  keypad  editor. 


2.6.2    The  EXIT  Command 

The  lull  lorm  ot  the  KXI  T  command  is  as  tollows.  The  keypad  editor  doe.s  not 
accept  any  abl)re\iation. 

E.;lT 

When  you  use  the  KXIT  command  to  stop  an  editing  session,  the  ke\  pad 
editor  completes  the  following  steps. 

1.  The  keypad  editor  closes  all  tiles. 

2.  The  keypad  editor  creates  or  renames  tiles,  il  necessary. 

'■\.  It  you  have  been  editing  or  creating  a  tile,  the  keypad  editor  saves  the 
results  ol  your  work,  including  an  open  auxiliary  output  tile. 

4.  The  keypad  editor  then  displays  the  prompt  you  see  when  you  start  any 
editing  session.  Therefore,  you  can  immediately  start  another  session  by 
typing  another  file  specification  string. 


2.6.3    The  QUIT  Command 

The  full  form  of  the  QUIT  command  is  as  follows.  The  keypad  editor  does  not 
accept  any  abbreviation. 

QUIT 


When  you  use  the  QUIT  command  to  stop  an  editing  session,  the  keypad 
editor  completes  the  following  steps. 

1.    The  keypad  editor  closes  all  input  files  without  changing  them  in  any  way. 
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2.  The  keypad  editor  purjies  your  main  output  file  (and  auxiliary  output  file, 
if  one  is  open).  "F\irge"  means  that  the  temporary  output  file  and  the 
main  output  file  are  not  preserved.  The  keypad  editor  displays  the  mes- 
safje 


■?  K  E  D  -  W  -  0  '.I  t  p  i.t  t.     files     purged. 


',].  The  keypad  editor  then  displays  the  same  prompt  that  you  see  when  you 
start  an  editing  session.  Therefore,  you  can  immediately  start  another 
session  by  typing  another  file  specification  string. 
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Chapter  3 
Inspecting  a  File 


This  chapter  describes  the  basic  functions  that  you  may  use  while  inspecting 
a  file.  While  you  are  reading,  refer  to  the  keypad  diagrams  for  the  VTIOO  and 
VT52  in  Figures  1-1  and  1-2.  Auxiliary  file  functions,  which  may  be  used 
when  you  are  inspecting  a  file,  are  described  in  Chapter  5. 


3.1    Using  the  Standard  and  Alternate  Functions 

Each  keypad  key  controls  a  standard  function  and  an  alternate  function.  To 
use  an  alternate  function,  use  the  GOLD  function  first  and  then  press  the 
keypad  or  keyboard  key  that  controls  the  alternate  function  that  you  want  to 
use.  For  example,  the  alternate  function  for  the  4  key  is  BOTTOM.  To  use  the 
BOTTOM  function,  press  the  GOLD  and  BOTTOM  keys  —  on  the  VTIOO 
keypad  the  PFl  key  and  then  the  4  key,  on  the  VT52  keypad  the  blue  key  and 
then  the  4  key. 


3.1.1    The  GOLD  Function 

VTIOO  Key:    The  PFl  key  on  the  keypad. 
VT52  Key:      The  blue  key  on  the  keypad. 

The  GOLD  function  by  itself  has  no  effect  on  the  file.  When  you  press  the 
GOLD  key,  the  keypad  editor  processes  the  alternate  function  of  the  next 
keypad  or  keyboard  key  that  you  press. 

The  GOLD  function  applies  only  to  the  single  function  that  follows.  For 
example,  to  move  the  cursor  first  to  the  top  of  the  file  and  then  to  the  bottom, 
you  must  press  the  following  sequence  of  keys  (the  TOP  and  BOTTOM  func- 
tions are  described  later  in  this  chapter): 


(  GOLD  )[  TOP  )(  GOLD  )  (BOTTOM) 
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A  sequence  of  consecutive  (lOLD  functions  is  equivalent  to  a  single  (tOLD 
function.  For  example,  the  following  sequences  both  execute  the  BOTTOM 
function  once: 


(  GOLD  )(  BOTTOM') 


(  GOLD  IfGOLD  )(  GOLD~)(  BOTTOM^ 

You  can  use  the  GOLD  function  at  any  time  except  when  the  Comiiiand  :  or 
Model  :  prompt  is  displayed.  (The  Model  :  prompt  is  for  searching  and  is 
explained  later  in  this  chapter.) 

3.1.2    The  RESET  Function 

VTIOO  Keys:    The  PFl  key  and  the  period  (.)  key  on  the  keypad. 
VT52  Keys:      The  blue  key  and  the  period  (.)  key  on  the  keypad. 

The  RESET  function  has  no  effect  on  your  file.  However,  the  function  is 
useful  in  two  cases: 

•  When  you  have  pressed  the  GOLD  key  and  then  decide  to  use  a  standard 
function  instead  of  an  alternate  function. 

•  When  you  have  built  a  select  range  and  then  decide  to  cancel  it  (Section  4.3 
describes  select  ranges  and  ways  to  use  them). 

For  example,  the  following  sequences  both  execute  the  WORD  function  once 
(the  ADVANCE,  BACKUP,  and  WORD  functions  are  described  later  in  this 
chapter): 


(  ADVANCE  )rGOLD)[  RESET  JTWORD  jflACKUP  ) 


[ ADVANCE  If  WORD  jfBACKUP  ) 

The  following  sequence  creates  a  select  range  with  two  text  lines  and  then 
cancels  the  select  range: 


fBLINE  ) fSELECT  )(  BLINE  ) (  BLINE  ) (  GOLD  ') TRESET  ) 

You  can  use  the  RESET  function  at  any  time  except  when  a  prompt  is 
displayed. 

3.2    Getting  Help:  The  HELP  Function 

VTlOO  Key:  The  PF2  key  on  the  keypad. 
VT52  Key:    The  red  key  on  the  keypad. 

When  a  keypad  editor  process  fails,  the  keypad  editor  signals  you  in  one  of  the 
following  ways: 

1.    The  keypad  editor's  normal  signal  is  to  ring  the  bell  on  your  terminal.  For 
K52,  this  is  the  only  signal. 
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2.    With  a  VTIOO,  you  can  also  set  KKI)  to  signal  quietly  by  using  the  SKT 
QlJIF/r  command  (the  command  is  described  later  in  this  section). 

In  each  case,  when  the  keypad  editor  signals  you,  it  loads  a  one-line  explana- 
tion of  the  signal  in  an  internal  message  butter.  When  you  use  the  HKLP 
(unction,  the  editor  temporarily  erases  the  bottom  three  screen  lines  and 
displays  the  explanation. 

For  example,  because  STOP  is  not  a  keypad  editor  command,  the  following 
sequence  causes  the  editor  to  signal  that  a  message  is  available: 


f  COMMAND^  STOP  (  ENTER] 

When  you  use  the  HELP  fvmction  after  that  sequence,  the  keypad  editor 
displays  the  following  message: 

Illegal     c  0  fiHii  a  ri  'J 

The  HELP  function  can  also  display  three  special  forms  that  summarize  the 
keypad  editor  features. 

The  first  form  displayed  is  a  screen  version  of  the  keypad  diagram.  KF^D 
displays  the  VTIOO  keypad  diagram  and  K52  displays  the  VT52  keypad  dia- 
gram. 

If  you  use  the  HELP  function  while  the  keypad  editor  is  displaying  a  keypad 
diagram,  the  keypad  editor  displays  the  second  form  which  is  a  summary  of 
all  keypad  editor  commands.  In  this  help  form,  KED  shows  the  valid  abbrevi- 
ation for  each  command  in  reverse  video  or  by  underlining,  depending  on  the 
form  of  the  cursor  that  you  are  using.  K52  shows  only  the  full  forms  of  the 
commands. 

If  you  use  the  HELP  function  again  without  an  intervening  function  or  com- 
mand, the  keypad  editor  displays  a  summary  of  the  GOLD  keyboard  com- 
mands. 

While  the  keypad  euitv)r  is  displaying  only  a  part  of  your  file,  use  the  HELP 
function  as  follows  to  display  a  keypad  editor  message  or  either  of  the  help 
forms: 

L    If  there  is  a  keypad  editor  message  in  the  message  buffer: 

•  The  first  HELP  function  displays  the  message. 

•  The  second  HELP  function  displays  the  keypad  diagram. 

•  The  third  HELP  function  displays  the  command  summary. 

•  The  fourth  HELP  function  displays  the  GOLD  keyboard  command 
summary. 

•  Subsequent  HELP  functions  alternately  display  the  diagram  and  com- 
mand summarv. 
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If  there  is  not  a  keypad  editor  message  in  the  message  buffer: 

•  The  first  HELP  function  displays  the  keypad  diagram. 

•  The  second  HELP  function  displays  the  command  summary. 

•  The  third  HELP  function  displays  the  GOLD  keyboard  command  sum- 
mary. 

•  Subsequent  HELP  functions  alternately  display  the  diagram  and  com- 
mand summary. 


When  a  message  or  help  form  is  displayed,  you  can  make  the  keypad  editor 
restore  all  lines  temporarily  erased  from  your  file  by  using  the  ENTER  or 
CTRL/W  function.  You  can  also  use  any  other  valid  keypad  editor  function. 
In  this  case,  the  keypad  editor  completes  the  function  before  repainting  the 
screen. 

You  can  use  the  HELP  function  at  any  time  except  when  a  keypad  editor 
prompt  is  displayed. 


3.3    Using  the  VT100  Commands 

Because  the  VTIOO  has  several  video  features  that  the  VT52  does  not  have, 
such  as  reverse  video  display  and  L32-column  screen  width,  KED  provides  six 
more  commands  than  K52.  The  commands  allow  you  to  adjust, your  VTlOO 
display  while  you  are  using  KED. 

The  SET  QUIET  and  SET  NOQUIET  commands  control  how  KED  signals 
you  when  a  command  or  function  fails. 

The  four  SET  SCREEN  commands  set  the  screen  width  to  80  characters  or 
132  characters  and  set  the  display  background  to  dark  or  light. 


3.3.1    Setting  KED's  IVIessage  Signal 

If  you  work  in  a  quiet  area,  you  can  use  the  SET  QUIET  command  to  set 
KED  to  signal  you  quietly  rather  than  with  the  VTIOO  terminal  bell.  You  can 
use  the  SET  NOQLHET  command  to  restore  the  bell  signal  whenever  you 
wish. 

3.3.1 .1  The  SET  QUIET  Command  —  The  form  of  the  SET  QUIET  command 
is: 

SET     QUIET 


The  SET  QUIET  command  .sets  KED  to  signal  you  without  sounding  the 
terminal  "bell"  about  commands  and  functions  that  fail. 
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When  a  command  or  function  fails,  KEI)  temporarily  reverses  the  background 
of  your  screen  to  indicate  that  a  function  failed.  To  see  an  explanation  of  the 
signal,  use  the  HELP  function.  To  continue  editing,  use  ENTER  or  any  other 
valid  function.  KED  then  restores  the  normal  background  and  executes  the 
command  or  function  that  you  specified. 

If  you  use  VTIOO  SETUP  commands  to  control  the  screen  display  back- 
ground, the  SET  QUIET  command  causes  the  screen  to  be  set  to  DARK  when 
a  function  fails.  However,  if  you  use  the  keypad  editor  SET  DARK  or  SET 
LIGHT  commands,  a  function  failure  will  reverse  the  background. 

The  SET  QUIET  command  is  illegal  with  K52. 

3.3.1.2  The  SET  NOQUIET  Command  —  The  general  form  of  the  SET  NO- 
QUIET  command  is: 

SET     NOQUIET 

The  SET  NOQUIET  command  sets  KED  to  signal  you  ab-ut  commands  and 
functions  that  fail  by  ringing  the  VTIOO  terminal  bell.  This  is  KED's  default 
signal.  To  see  an  explanation  of  the  signal,  use  the  HELP  function.  To  con- 
tinue editing,  use  the  ENTER  or  CTRLAV  functions,  or  use  any  other  valid 
functi(m. 

The  SET  NOQUIET  command  is  illegal  with  K52. 

3.3.2    Setting  the  VT100  Screen  Width  and  Background 

As  noted  earlier  in  this  manual,  you  can  set  your  VTIOO  screen  width  and 
background  before  you  start  KED  by  using  the  VTlOO's  SETUP  A  and 
SETUP  B  features.  The  SETUP  features  are  described  in  your  VTKlO  User 
Guide.  For  your  convenience,  KED  also  provides  two  sets  of  commands  that 
you  can  use  to  adjust  your  VTIOO  screen  while  you  are  editing. 

The  SET  SCREEN  80  and  SET  SCREEN  132  commands  set  the  VTIOO 
screen  width. 

The  SET  SCREEN  LIGHT  and  SET  SCREEN  DARK  commands  set  the 
VTIOO  screen  background. 

The  default  settings  are  the  settings  that  are  in  effect  when  you  start  KED. 

3.3.2.1  The  SET  SCREEN  80  Command  —  The  general  form  of  the  SET 
SCREEN  80  command  is: 


SETL     SCREE^']     BO 


After  the  SET  SCREEN  80  command,  KED  sets  the  VTUX)  terminal  for  80 
characters  per  screen  line.  In  order  to  display  all  line  terminators  correctly, 
the  maximum  number  of  printing  characters  on  a  screen  line  in  this  case  is  78. 

The  SET  SCREEN  80  command  is  illegal  with  K52. 
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3.3.2.2    The  SET  SCREEN  132  Command 

SC'KKK.N  l.<2  I'oiniuand  i>: 

SET[  SCREEN]  132 


Vhv  tit'iuTiil  torin  <•(  the  SKT 


After  the  SET  SCRKKN  V.V2  command.  KKI)  sets  the  VTKM)  terminal  tor  \:V2 
characters  per  screen  line.  In  order  to  display  all  line  terminators  correctl\. 
the  maximum  numl)er  ot  printing  characters  on  a  screen  line  in  this  case  is 
VM). 

The  SKT  SCHKKN  \:V2  command  is  ille^jal  with  Kr)J. 


3.3.2.3    The  SET  SCREEN  DARK  Command 

SC'KHKN  D.AHK  command  is; 


The  general  form  ot  the  ^K'V 


SETC     SCREEN]     DARK 


After  the  SET  SC^HRKN  DARK  command,  KKI)  sets  the  VVUM)  terminal  to 
display  all  printing  characters  as  light  characters  on  a  dark  background.  The 
non-print ing  characters,  such  as  spaces  and  New  Line  terminators,  are  not 
displayed. 

The  SKT  SCRKKN  DARK  command  is  illegal  with  Kr>2. 


3.3.2.4    The  SET  SCREEN  LIGHT  Command  —    The  general  form  ot  the  SKT 
SCREF^N  LIGHT  command  is: 


SETC  SCREEN]  LIGHT 


After  the  SF:T  SCRKEN  LIGHT  command.  KED  sets  the  VTIOO  terminal  to 
display  all  printing  characters  as  dark  characters  on  a  light  background.  The 
term  mcrsc  ridro  refers  to  this  display  method.  The  non-printing  characters 
such  as  spaces  and  New  Line  terminators  are  not  displayed. 

The  SET  SCREEN  LIGHT  command  is  illegal  with  Ko2. 

3.4   Terminating  Commands  and  Finishing  with  HELP:  The  ENTER 
Function 

\'T10()  and  \T52  Keys:     The  Enter  key  on  the  keypad. 
The  ENTER  function  has  the  following  effects: 

L  When  you  are  entering  a  command,  the  F^NTER  function  terminates  the 
command  string  and  causes  the  keypad  editor  to  begin  executing  the 
command. 

2.  When  you  are  displaying  a  keypad  editor  HELP  message  or  any  form  of 
the  HELP  function,  ENTER  terminates  the  HELP  sequence  and  re-dis- 
plays your  file  on  the  screen. 

The  ENTER  function  is  invalid  only  when  the  Mo  d  e  1  :  prompt  is  displayed. 
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3.5    Verifying  that  the  Display  Is  Up-To-Date:  The  CTRL/W 
Function 

VTIOO  and  VT52  Keys:     Hold  down  the  CTRL  key  while  you  type  the  letter 

W  on  the  keyboard. 

The  CTRLAV  function  repaints  each  character  ot  your  tile  that  should  he  in 
your  display  and  thus  verifies  that  your  display  illustrates  exactly  what  is  in 
your  file.  Three  cases  in  which  the  CTRLAV'  function  is  especially  useful  are 
as  follows: 

1.  When  the  keypad  editor  is  displaying  a  message  or  the  keypad  diagram 
after  you  have  used  the  HELP  function. 

2.  When  the  operating  system  has  forced  a  system  message  to  your  terminal 
while  you  are  using  the  keypad  editor  Most  messages  of  this  type  are 
written  over  part  of  the  text  line  that  contains  the  keypad  editor's  cursor. 

:].  To  reset  the  keypad  editor  to  applicaticm  mode,  that  is.  to  cause  the 
keypad  t  i  generate  the  escape  sequences  used  by  the  keypad  editor  in- 
stead of  the  numbers  generated  when  not  using  the  keypad  editor. 


You  can  use  the  CTRL/W  function  at  any  time  except  when  the  Model:  or 
Command  :  prompt  is  displayed. 


3.6    Cancelling  the  Keypad  Editor's  Process:  The  CTRL/C 
Function 

VTlOO  and  VT52  Keys:     Hold  down  the  CTRL  key  while  you  type  the  letter 

C  on  the  keyboard. 

The  CTRL/C  function  cancels  any  process  that  the  keypad  editor  is  executing. 
After  >ou  use  the  CTRL/C  function,  the  keypad  editor  immediately  stops 
what  it  is  executing  and  displays  the  part  of  your  file  where  the  cursor  is 
located.  The  keypad  editor  then  signals  you  that  a  process  has  been  cancelled. 
If  you  then  use  the  HELP  function,  the  keypad  editor  displays  the  following 
message: 


CTRL/C  entered  to  stop  operation 


The  CTRL/C  function  is  especially  useful  when: 

L  The  keypad  editor  is  executing  a  long  process  that  you  want  to  cancel.  For 
example,  in  a  large  file,  the  keypad  editor  may  require  several  seconds  to 
complete  the  BOTTOM  function.  While  the  editor  is  executing  the  func- 
tion, you  can  cancel  it  by  using  the  CTRL/C  function. 

2.  You  accidentally  use  the  wrong  function.  For  example,  if  you  accidentally 
search  backward  instead  of  forward,  you  can  cancel  the  search  by  using 
the  CTRL/C  function. 
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n.  Vou  change  your  mind  about  creating  or  copying  an  auxiliary  file.  For 
example,  it  you  enter  the  command  to  copy  5()  pages  from  a  long  auxiliary 
input  file,  you  can  cancel  the  process  by  using  the  CTRL/C  function. 

4.  You  enter  a  misspelled  or  incorrectly  typed  character  string  as  a  model  for 
a  FIND  functiim.  You  can  cancel  the  FIND  operation  by  typing  ("rilL/C. 

The  CTRL/C  function  has  no  effect  on  the  part  of  a  keypad  editor  process  that 
is  complete.  The  process  simply  stops  and  the  keypad  editor  displays  the 
cursor  wherever  it  has  moved. 

If  you  use  the  CTRL/C  function  while  you  are  entering  a  command  or  a  search 
model,  the  keypad  editor  cane  Is  the  COMMAND  or  FIND  function  immedi- 
ately and  signals  that  it  has  done  so.  If  you  then  use  the  HF.LP  function,  the 
keypad  editor  displays  one  of  the  following  messages: 


C  0  (II  (ti  a  ri  d     cancels  d 

M  0  'i  e  1     prompt     c  a  ri  c  e  I  e  d 


If  the  keypad  editor  is  not  executing  any  process  when  you  use  the  CTRL/C 
function,  the  keypad  editor  signals  that  it  is  ignoring  the  function.  If  you  then 
use  the  HELP  function,  the  keypad  editor  displays  the  following  message: 


CTRL/C  or  CTRL. 


1  a  ri  0  r  e  d 


use  QUIT 


The  message  is  worded  in  that  way  because  CTRL/C  and  CTRL/Z  are  the 
most  common  ways  to  stop  many  of  the  other  programs  and  utilities  that  your 
operating  system  provides.  However,  the  keypad  editor,  protecting  you  from 
the  bad  effects  of  accidentally  typing  CTRL/C,  requires  that  you  use  the 
QUIT  command  to  stop  editing. 

You  can  use  the  CTRL/C  function  at  any  time,  but  it  has  no  effect  unless  the 
keypad  editor  is  executing  a  process. 


3.7    The  Arrow  Functions 


The  arrow  functions  are  controlled  by  the  VT52's  arrow  keys  on  the  keypad 
and  the  VTlOO's  arrow  keys  at  the  upper  right  corner  of  the  keyboard.  The 
four  arrow  functions  always  move  the  cursor  as  directly  as  possible  in  the 
directions  of  the  arrows  on  the  keys. 

The  rightarrow  function  moves  the  cursor  to  the  right  and  from  a  line  termi- 
nator to  the  beginning  of  the  next  text  line. 

The  downarrow  function  moves  the  cursor  straight  down. 

The  leftarrow  function  moves  the  cursor  to  the  left  and  from  the  beginning  of 
a  line  to  the  preceding  line  terminator. 

The  uparrow  function  moves  the  cursor  straight  up. 
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3.7.1    The  RIghtarrow  Function 

VTIOO  Key;    The  rijihtarrow  key  on  the  keyboard. 
VT52  Key:      The  right  arrow  key  on  the  keypad. 

The  rightarrow  function  moves  the  cursor  to  the  character  that  follows  the 
current  character.  When  the  cursor  moves  from  a  line  terminator,  the  keypad 
editor  generally  scrolls  the  file  upward. 

Example:  The  following  example  shows  how  the  rightarrow  function  moves 
the  cursor  in  three  cases. 

KED  displayP  the  CTRL/T  character  as  M.  |In  this  case, 

^T  is  a  single  character  in  the  file,  although  KED  uses  twol 

screen  positions  to  display  it. 

The  rightarrow  function  is  invalid  when: 

1.  The  cursor  is  on  the  end-of-file  symbol. 

2.  A  prompt  is  on  the  screen. 
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3.7.2    The  Downarrow  Function 

VTlOO  Key:    The  downarrow  key  on  the  keyhoard. 
VT52  Key:      The  downarrow  key  on  the  keypad. 

The  downarrow  function  moves  the  cursor  to  the  following'  text  line.  II  a 
character  is  directly  under  the  current  character,  the  cursor  moves  to  it. 
Otherwise,  the  cursor  moves  left  within  the  target  line  to  the  nearest  char- 
acter.' The  keypad  editor  generally  scrolls  the  file  upward. 

F^xample:  The  following  example  shows  how  three  consecutive  downarrow 
funi'tions  move  the  cursor. 


10  FOR  A7.  =  1  TO  12| 

20  IF  T   15.6  THEN*PRINT  'A7.=  ';A7. 

30  NEXT  A// 

40  GOSUB  500  \  REM  A7.  SAMPLE  COMPLETE,  PROCESS  AS 


When  you  use  cf)nsecutive  downarrow  functions,  the  cursor  may  stop  to  the 
left  of  its  initial  screen  column  in  .some  text  lines.  The  reason  is  as  follows.  The 
downarrow  function  always  moves  the  cursor  to  a  real  character  in  your  file. 
F^ach  space  is  a  real  character,  but  the  blank  columns  that  follow  line  termi- 
nators and  Horizontal  Tab  characters  are  not  really  spaces  that  are  in  your 
file.  Therefore,  whenever  the  downarrow  function  moves  the  cursor  to  the 
right  of  a  line  terminator,  the  keypad  editor  places  the  cursor  on  the  termi- 
nator. In  most  cases,  when  the  cursor  moves  into  a  blank  that  follows  a 
Horizontal  Tab  character,  the  keypad  editor  places  the  cursor  on  the  tab. 

The  downarrow  function  is  invalid  when: 

1.  The  cursor  is  on  the  end-of-file  symbol. 

2.  A  prompt  is  on  the  screen. 


However,  when  the  downarrow  function  moves  the  cursor  into  a  text  line  that  follows  a  single 
Linefeed  character,  the  cursor  moves  to  the  right  within  the  text  line  because  the  blank  at  the 
beginning  of  the  text  line  does  not  represent  a  real  character  in  your  file. 
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3.7.3    The  Leftarrow  Function 

V'TlOO  Key:    The  leftarrow  key  on  the  keyl)oard. 
VT52  Key:      The  leftarrow  key  on  the  keypad. 

The  leftarrow  function  moves  the  cursor  to  the  character  preceding  the  cur- 
rent character.  When  the  cursor  moves  to  a  line  terminator,  the  keypad  editor 
generally  scrolls  the  file  downward. 

F^xample:  The  following  example  shows  how  the  leftarrow  function  moves  the 
cursor  in  three  cases. 

KED  Moves  the  Bursor  with  the  arrow|f unctions,  searching  functions 
and  functions  that  detect  units  of  text,  such  as  'words'.  The. 
^rrow  functions  are  «ost  useful  for  SMall  cursor  adjustments. 

The  leftarrow  function  is  invalid  when: 

1.  The  cursor  is  at  the  top  of  the  file. 

2.  A  prompt  is  on  the  screen. 
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3.7.4   The  Uparrow  Function 

VTIOO  Key:    The  uparrow  key  on  the  keyboard. 
VTr)2  Key:      The  uparrow  key  on  the  keypad. 

The  uparrow  function  moves  the  cursor  to  the  preceding  text  Hne.  If  a  char- 
acter is  directly  above  the  current  character,  the  cursor  moves  to  it.  Other- 
wise, the  cursor  moves  left  to  the  nearest  character  in  the  target  text  hne.'  The 
keypad  editor  generally  scrolls  the  file  downward. 

P^xample:  The  tollowing  example  shows  how  two  consecutive  uparrow  func- 
tions move  the  cursor. 

KED  Moves  the  cursor  uith  the  arrow  functions,  searching  functions 
and  functions  that  detect  units  of  text,  such  as  'words'.  The 
arrow  functions  are  wost  usefuB  for  SMall  cursor  adjustments. 

When  you  use  consecutive  uparrow  functions,  the  cursor  may  stop  to  the  left 
of  its  initial  screen  column  i.i  some  lines.  The  reason  is  as  follows.  The 
uparrow  function  always  moves  the  cursor  to  a  real  character  in  your  file. 
p:ach  space  (AS(MI  octal  040)  is  a  real  character,  but  the  blank  columns  that 
tbllow  line  terminators  and  Horizontal  Tab  characters  are  not  really  spaces 
that  are  in  your  file.  Whenever  the  uparrow  function  moves  the  cursor  to  the 
right  of  a  line  terminator,  the  keypad  editor  places  the  cursor  on  the  termi- 
nator. In  most  cases,  when  the  cursor  moves  into  a  blank  that  follows  a 
Horizontal  Tab  character,  the  keypad  editor  places  the  cursor  on  the  tab. 

You  cannot  use  the  uparrow  function  when  a  prompt  is  on  the  screen. 


'  However,  when  the  uparrow  tumtion  moves  the  cursor  into  a  text  line  that  follows  a  single 
Linefeed  character,  the  cursor  moves  to  the  rij^ht  within  the  text  line  hecause  the  blank  at  the 
be^inninj;  ol  the  text  line  does  not  represent  any  real  characters  in  your  file. 


3-12        Inspecting  a  File 


3.8    Controlling  the  Direction  the  Cursor  Moves 

The  kt'vpiul  i-dit-ir  hM>  two  (lirettional  modes:  harkup  and  advance.  As  a 
result,  you  ran  instrurt  the  editor  to  perform  mans  tunctions  in  either  direc- 
tion. In  the  backup  mode,  the  ke\  pad  echtor  mo\es  the  cur--or  to  the  left  and 
upward,  that  is.  toward  the  hejiuimnf,'  of  the  file.  In  the  advance  mode,  the 
keypad  editor  mt)ves  the  cursor  to  the  rijjht  and  downward,  that  i>.  towards 
the  bottom  of  the  file.  The  .M)\AN('K  and  BACKl'l*  tunctiorvs  >et  the  direc- 
tional mode. 

The  arrow  functions  are  not  affected  by  the  directional  mode.  They  always 
move  the  cursor  m  the  direction,-  indicated  by  the  arrows  on  the  keys. 

3.8.1  The  ADVANCE  Function 

\"riiKi  Mild  \  r.'iJ  Ke\:      The   I  kev  on  the  kevpad. 

The  A1)\'.AN('K  function  sets  the  keypad  editor  t,,  the  advance  ni<»de.  After 
you  press  the  .A1)\'.\\('K  key,  the  cursor  movement  functions  advance  the 
cursor  toward  tar^'ets  that  are  to  the  ri^ht  of  the  cursor  and  below   it. 

For  an  example  of  the  .ADWANCK  function,  see  the  examples  for  the  WORD 
function  and  the  HLINK  function  below. 

^"ou  cannot  u-e  the  .M)\'.-\N('K  function  when  the  prompt  Commaiid:  is 
displayed.  When  you  are  completing,'  a  model  tor  the  FIND  function,  the 
,M)\AN(T'.  function  terminates  the  model  and  directs  the  keypad  editor  to 
search  toward  the  bottom  of  \our  tile  for  a  tar^'et  that  matches  the  model. 

3.8.2  The  BACKUP  Function 

VTKM)  and  VT.")2  Key:    The  ')  key  on  the  keypad. 

The  HACKIP  function  ,-<ets  the  keypad  editor  to  the  f)ackup  mode.  .After  you 
press  the  H-ACKl'I'  key.  the  cursor  movement  functions  back  the  cursor  up 
toward  tar^'ets  that  are  to  the  left  of  the  cursor  and  above  it. 

For  an  examj)le  of  the  B.ACKl'l*  function,  see  the  examples  for  the  WORD 
function  and  the  HMNF  function  below. 

You  cannot  use  the  BAl'Kl'P  function  when  the  prompt  Codunand  :  is  dis- 
plaved.  When  you  are  completing;  a  model  for  the  FIND  function,  the 
H.ACKl'P  function  terminates  the  model  and  directs  the  keypad  editor  to 
search  toward  the  top  of  your  file  for  a  tarj^et  that  matches  the  model. 
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3.9    Moving  the  Cursor  by  Characters,  Words,  and  Lines 

The  keypad  editor  processes  tiles  in  terms  ol  five  units  ot  text. 

•  Characters. 

•  Words. 

•  Text  lines. 

•  Sections  (discussed  in  Section  '].\\). 

•  Pages  (also  discussed  in  Section  ;?.ll). 

Characters  include  the  letters  of  the  alphabet,  digits,  and  all  other  printing 
and  non-printing  characters  in  the  AS(TI  character  set. 

Words  are  strings  of  printing  characters  and  the  spaces  that  follow  them,  in 
most  cases.  However,  the  keypad  editor  treats  the  Horizontal  Tab  character 
and  each  of  the  four  line  terminators  that  the  keypad  editor  recognizes  as  a 
word  by  itself. 

Text  lines  are  strings  of  printing  and  non-printing  characters  that  end  with 
one  of  the  four  line  terminators  the  keypad  editor  recognizes: 

1.  The  Carriage  Return  —  Linefeed  pair  (the  New  Line  terminator). 

2.  The  Vertical  Tab  character. 

3.  The  Formfeed  character. 

4.  A  Linefeed  character  (without  a  preceding  Carriage  Return  character). 

This  chapter  distinguishes  text  lines  from  screen  lines  because  the  keypad 
editor  uses  as  many  screen  lines  as  necessary  for  displaying  each  text  line  that 
is  in  your  file.  However,  the  functions  that  process  text  lines,  such  as  the 
BLINE  function,  generally  have  the  same  effects  regardless  of  the  number  of 
screen  lines  that  a  text  line  requires. 

Sections  and  pages  can  be  defined  to  allow  you  to  move  the  cursor  by  using 
groups  of  lines  or  by  searching  for  certain  characters. 
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3.9.1    The  CHAR  Function 

V'TIOO  Key:  The  'A  key  on  the  keypad. 

Ki'Vl  does  not  include  a  CHAR  tunction  because  the  arrow  hinctions  are  con- 
trolled by  keypad  keys  on  the  \"1T)2.  Therelore.  with  Kr)2  use  the  lettarrow 
and  ri^htarrow  functions. 

Depending  on  directional  mode,  the  CHAK  function  advances  or  backs  up  the 
cursor  one  character.  When  the  cursor  moves  to  a  dilTerent  line,  the  keypad 
editor  generally  scrolls  the  file  in  the  opposite  direction. 

Example:  The  following  example  shows  how  the  CHAR  function  advances 
and  backs  up  the  cursor  in  three  cases. 

Leftarrow  and  [ightarrow  are  equivalent  to|the  sequences^ 
lACKUP  CHAR  and  ADVANCE  CHAR. 

Note  that  the  keypad  editor  displays  the  Horizontal  Tab  character  (ASCII 
octal  Oil)  as  a  blank  that  starts  at  the  tab  character's  real  position  and  ends 
at  the  next  normal  hardware  tab  stop  (columns  1,  9,  17.  etc.).  Therefore,  a 
blank  that  is  caused  by  a  tab  character  looks  the  same  as  a  blank  that  is 
caused  by  an  equivalent  number  of  spaces  (ASCII  octal  040).  Usually  the  file's 
context  will  distinguish  between  the  two  cases,  but  you  can  also  use  the 
CHAR  function  to  distinguish  them.  In  most  cases  when  a  tab  ch_.racter  is 
present,  the  CHAR  function  makes  the  cursor  skip  more  than  one  print  posi- 
tion backward  to  a  tab  character  and  forward  from  a  tab  character. 

The  CHAR  function  is  invalid: 

1.  In  the  backup  mode  when  the  cursor  is  at  the  top  of  the  file. 

2.  In  the  advance  mode  when  the  cursor  is  on  the  end-of-file  symbol. 

3.  When  a  prompt  is  displayed. 
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3.9.2    The  WORD  Function 

VTIOO  and  VTfyi  Key:  The  1  key  on  the  keypau. 

Depending  on  directional  mode,  the  WORD  function  advances  or  backs  up 
the  cursor  to  the  first  character  of  a  word.  When  the  cursor's  character  is  the 
first  character  of  a  word,  the  cursor  advances  to  the  first  character  of  the  next 
word  or  backs  up  to  the  first  character  of  the  preceding  word.  When  the  cursor 
moves  to  a  different  Hne,  the  keypad  editor  generally  scrolls  the  file  in  the 
opposite  direction. 

Example:  The  following  example  shows  how  the  WORD  function  advances 
and  backs  up  the  cursor  in  three  cases.  In  each  case,  the  cursor  moves  to  a 
word  boundarv. 


# 


Host  punctuation  characters  and  spaces  are  parts  of  words.  A 
space  IS  never  the  first  character  in  a  word  except  when 
it  is  the  first  character: 

1.  In  a  file. 

2.  In  a  text  line.   ,^— ^ 

3.  Following  a  Tab  ch^acter> 

To  KED,  each  of  the  following  strings  is  a  word: 
^AB347T,    pHAT,     I)K3:REH.THP 


The  WORD  function  is  invalid: 

1.  In  the  backup  mode  when  the  cursor  is  at  the  top  of  the  file. 

2.  In  the  advance  mode  when  the  cursor  is  on  the  end-of-file  symbol. 

3.  When  a  prompt  is  displayed. 


3-16       Inspecting  a  File 


3.9.3    The  BLINE  Function 

VTlOd  and  ¥752  Key:  The  0  key  on  the  keypad. 

Depending  on  directional  mode,  the  BLINK  function  advances  or  backs  up 
the  cursor  to  the  t'i:st  character  of  a  text  line.  When  the  cursor's  character  is 
the  first  character  of  a  text  line,  the  cursor  advances  to  the  first  character  of 
the  next  text  line  or  backs  up  to  the  first  character  of  the  preceding  text  line. 
When  the  cursor  moves  to  a  different  line,  the  keypad  editor  generally  scrolls 
the  file  in  the  opposite  direction. 

p]xample:  The  following  example  shows  how  three  consecutive  BLINE  func- 
tions advance  and  back  up  the  cursor.  In  either  direction,  the  cursor  moves  to 
the  character  that  follows  a  line  terminator. 

100  REM  Read  Pnd  store  up  to  10  ASCII  lines 


'J 


^110  OPEN  "DKO:SAMPLE.TXT"  FOR  INPUT  AS  FILE  14 
Sl20  FOR  C7.  =  1  TO  10 
S30  LINPUT  A$(C7.) 

.140  IF  END  14  GO  TO  500 
^^^150  NEXT  C7. 

500  STgP 


The  BLINE  function  is  invalid: 

L    In  the  backup  mode  when  the  cursor  is  at  the  top  of  the  file. 

2.  In  the  advance  mode  when  the  cursor  is  on  the  end-of-file  symbol. 

3.  When  a  prompt  is  displayed. 
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3.9.4    The  EOL  Function 

VTIOO  and  VTfyi  Key:  The  2  key  on  the  keypad. 

Depending  on  the  directional  mode,  the  HOL  (unction  advances  or  hacks  up 
the  cursor  to  the  nearest  Hne  terminator.  When  the  cursor  starts  on  a  Une 
terminator,  the  KOL  function  advances  the  cursor  to  the  next  Hne  terminator 
or  hacks  it  up  to  the  preceding  Hne  terminator.  When  the  cursor  moves  to  a 
different  text  Hne.  the  keypad  editor  generaUy  scroHs  the  Hie  in  the  opposite 
direction. 

P'.xample:  The  foHowing  example  shows  how  the  KOL  function  advances  and 
hacks  up  the  cursor.  The  ^  symhol  is  shown  only  to  clarify  that  the  target  for 
the  EOL  function  is  a  line  terminator  (the  keypad  editor  does  not  display  the 
svmhol). 


35 

12.6039 

36 

0.645} 
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9.138 

I 
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SE 
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The  EOL  function  is  invalid: 

L    In  the  backup  mode  when  the  cursor  is  at  the  top  of  the  file. 

2.  In  the  advance  mode  when  the  cursor  is  on  the  end-of-file  symbol. 

3.  When  a  prompt  is  displayed. 
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ISI 


3.10    Moving  the  Cursor  to  the  Top  and  Bottom  of  a  File 

From  any  l.Kation  in  the  file  that  you  art-  editing,  you  can  move  the  cursor 
directly  to  the  hottom  ot  the  tile  or  to  the  to[)  of  the  tile. 

Moving  the  cursor  to  the  bottom  is  useful  when  you  want  to  extend  the  tile. 
For  example,  when  you  want  to  complete  a  memo  that  you  started  in  an 
earlier  keypad  editor  session,  you  can  use  the  tollowing  procedure: 

1.  Start  the  keypad  editor. 

2.  Specify  the  name  ot  the  file  that  contains  the  incomplete  memo. 

'.\.    When   the   keypad   editor  displays  the   first    lines  of  the   file,    use  the 
BOTTOM  tunction  to  move  the  cursor  directly  to  the  bottom. 

4.    In.sert  the  material  that  you  want  to  add. 

Moving  the  cursor  to  the  top  is  useful  when  you  want  to  add  material  before 
the  first  character  in  the  file  and  when  you  want  to  start  other  editing  pro- 
cesses from  the  top  of  the  file. 

3.10.1  The  BOTTOM  Function 

VTIOO  Keys:    The  PFl  key  and  the  4  key  on  the  keypad. 
VTfVi  Keys:      The  blue  key  and  the  4  key  on  the  keypad. 

The  BOTTOM  function  moves  the  cursor  directly  to  the  end-of-file  symbol. 
When  the  cursor's  original  position  is  far  above  the  bottom  of  the  file,  the 
keypad  ediiv)r  may  temporarily  erase  the  top  two  screen  lines  and  display  the 
message  WORKING.  .  .  .  When  the  keypad  editor  completes  the  function, 
tl"'  kf  'pad  editor  displays  the  cursor  on  the  end-of-file  symbol. 

.     The  BOTTOM  (unction  is  invalid  when: 

1.  The  cursor  is  on  the  enci-ot-file  symbol. 

2.  A  prompt  is  displayed. 

3.10.2  The  TOP  Function 

VTKK)  Keys:    The  FFl  key  and  the  5  key  on  the  keypad. 
VT52  Keys:      The  blue  key  and  the  n  key  on  the  keypad. 

The  TOP  function  moves  the  cursor  directly  to  the  first  character  in  the  file. 
When  the  cursor's  original  position  is  far  below  the  top  of  the  file,  the  keypad 
editor  may  temporarily  erase  the  top  two  screen  lines  and  display  the  message 
WORK  ING  .  .  .  .  When  the  keypad  editor  completes  the  function,  the  keypad 
editor  displays  the  cursor  in  column  1  of  the  first  screen  line. 

The  TOP  function  is  invalid  when: 

1.  The  cursor  is  at  the  top  ot  the  file. 

2.  A  prompt  is  displayed. 
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3.11    Moving  the  Cursor  by  Pages  and  Sections 

Detiniii^'  pact's  and  sections  ot  text   ptTtiiits  easy  access  to  and  handling  of 
your  tile.  >'ou  can  define  these  units  in  one  of  the  following,'  ways: 

•  liy  hne-count 

•  by  marker-strings 

The  defauh  del init ions  are  a  single  Formfeed  character  for  a  page  and  l(i  text 
lines  for  a  section. 


3.11.1    Using  Line-Count  DefinitSons 

To  define  a  page  or  section  by  line-count,  specify  the  number  (.  text  lines  that 
you  want  the  keypad  editor  to  jump  over  when  you  use  the  l*A(iK  >  r  SKC- 
TION  t unction. 

For  example,  it  you  define  a  section  as  'J4  lines,  the  keypad  editor  advances  or 
liacks  up  the  cursor  by  24  lines  each  time  you  use  the  SHCTION  function.  In 
this  case,  the  SKCTION  tutiction  has  the  same  effect  as  24  consecutive 
BLINK  functions. 


3.11.2  Using  Marker-String  Definitions 

To  define  a  page  or  section  by  a  marker-string,  specify  the  string  of  characters 
that  exist  as  text  in  your  file  which  you  wish  to  use  to  indicate  the  beginning 
of  pages  or  sections  of  your  file.  Each  time  that  you  use  the  PA(1E  or  SEC- 
TION function,  the  keypad  editor  searches  for  the  marker-string  that  you 
specified. 

For  example,  if  you  define  a  section  w^ith  the  string  SECT,  the  keypad  editor 
advances  or  backs  up  the  cursor  to  the  nearest  occurrence  of  that  string  each 
time  you  use  the  SECTION  function.  Note  that  this  will  find  occurrences  of 
PSECT  and  CSECT  in  your  file  and  will  use  them  as  SECTION  marker- 
strings.  In  this  case,  the  SECTION  function  has  the  same  effect  as  the  FIND 
function  in  searching  tor  the  marker-string. 

3.11.3  Setting  the  Page  Definition:  The  SET  ENTITY  PAGE 
Command 

The  treneral  forms  of  the  command  to  set  the  page  definition  are: 


5ET  [ENTITY  DPAGE  ■  nuirkfr-strim;" 
SET  [ENTITY  IPAGE  '  martnr-stnnf^ ' 
SET     [ENTITY     ]PAGE    inteficrl     L^INES] 

The  ♦"irst  two  forms,  which  are  equivalent,  set  a  marker-string  definition.  The 
marker-string  must  be  enclosed  within  matching  single  quotes  (  ' )  or  double 
quotes  (").  Th"  marker-string  can  be  up  to  58  characters  long  and  can  contain 
any  printing  characters  or  line  terminators. 

The  third  form  sets  a  line-count  definition  The  integer  can  be  from  1  to 
:V2767. 
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3.11.4  Setting  the  Section  Definition:  The  SET  ENTITY  SECTION 
Command 

The  general  forms  ot  the  command  to  set  the  section  definition  are: 

SET  [ENTITY  ]  SECT  ION  '' mnrkir-strinn" 
SET  [ENTITY  ]SECT  ION  '  nuirkcr-strinn  ' 
SET     [ENTITY     ]5ECT  ION    intv^vri    J^INES] 

The  first  two  forms  set  a  marker-string  definition  and  are  equivalent.  The 
marker-string  must  he  enclosed  within  matching  single  quotes  (')  or  double 
quotes  (").  The  marker-string  can  be  up  to  ")!  characters  long  and  can  contain 
any  printing  characters  or  line  terminators. 

The  third  form  sets  a  line-count  definition.  The  integer  can  be  from  1  to 
32767. 

3.11.5  Other  Settings  that  Affect  Page  and  Section  Usage 

When  you  define  a  page  or  section  in  terms  of  a  marker-string,  the  keypad 
editor  u.ses  a  searching  procedure  to  locate  it  in  y(>ur  file  (later  sections  de- 
scribe the  searching  functions).  The  current  setting  for  search  matching 
(exact  or  general)  determines  the  way  the  keypad  editor  processes  pages  or 
sections. 

For  example,  if  you  define  a  page  with  the  string  Pa^e  and  the  keypad  editor 
is  set  for  general  matches  during  searching,  the  keypad  editor  ignores  all  case 
distinctions  in  the  marker-string  and  detects  Fade,  PAGE,  and  pade  as  the 
same  marker-string. 

If  Pa^e  is  your  marker-string  and  the  keypad  editor  is  set  to  search  for  exact 
matches,  the  keypad  editor  detects  Fade  as  the  only  legitimate  marker- 
string. 
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3.11.6    The  PAGE  Function 

VTIOO  and  VT52  Key:  The  7  key  on  the  keypad. 

When  a  page  is  defined  by  a  marker-string,  the  PAfrE  function  advances  or 
backs  up  the  cursor  to  the  first  character  that  follows  the  marker-string.  The 
default  definition  of  a  page  is  in  terms  of  a  single  Formfeed  character  as  the 
marker-string. 

When  a  page  is  defined  by  line-count,  the  PA(1E  function  advances  or  backs 
up  the  cursor  by  the  equivalent  number  of  BLINK  functions. 

Example:  The  following  example  shows  how  three  consecutive  '^AGE  func- 
ti(ms  advance  and  back  up  the  cursor  in  three  cases: 

1.  Advancing,  with  the  default  definition  of  a  page  la  single  Formfeed  char- 
acter as  shown  by  the  symbol    F^  on  the  VTIOO  and         on  the  VT52). 

2.  Advancing,  with  a  page  defined  as  one  colon  (  :  ). 

'A.  Backing  up,  with  a  page  defined  as  the  string  PAGE  and  with  exac.  search 
matching.  (In  this  case,  the  keypad  editor  skips  the  string  Pafle  near  the 
middle  of  the  example.) 


UORDS  BEGINNgNG  WITH  P:> 


UORDS  BEGINNING  yiTH  Q: 


Quick 
Quite 

UORDS  BEGINNING  yiTH  R: 


PAGE ^7 


PAGERS 

I 


PAGE^9 


Rabbilj 

Road 

Rubij 
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You  can  use  the  SP7r  ENTITY  PA(iP3  command  to  change  the  definition  of  a 
page  at  any  time  while  you  are  using  the  keypad  editor. 

The  PAOP]  function  is  invalid: 

1.  In  the  backup  mode  when  the  cursor  is  at  the  top  of  the  file. 

2.  In  the  advance  mode  when  the  cursor  is  on  the  end-of-file  symbol. 

3.  When  a  prompt  is  displayed. 

3.11.7    The  SECTION  Function 

YTIOO  Key:    The  8  key  on  the  keypad. 

VTo2  Keys:    The  blue  key  and  the  dowuarrow  key  on  the  keypad. 

The  only  significant  differences  between  the  PAGE  and  SECTION  functions 
are  that  they  use  different  keypad  keys  and  that  they  have  different  default 
definitions.  The  default  definition  of  a  section  is  16  consecutive  text  lines. 

3.12    Searching  for  Strings  in  a  Filie 

The  most  flexible  way  to  move  the  cursor  through  a  file  is  by  searching  for 
strings  of  characters  and  moving  the  cursor  to  them.  The  PAGE  and  SEC- 
TION functions  use  searching  to  locate  and  display  parts  of  a  file  in  terms  of 
the  page  and  section  marker-strings  that  you  have  specified.  The  FIND  and 
FINDNEXT  functions  are  more  convenient  for  moving  the  cursor  directly  to 
strings  whose  locations  you  do  not  know. 

The  FIND  function  searches  for  a  new  string.  The  keypad  editor  asks  tor  a 
model  of  the  string  you  are  looking  for  and  advances  or  backs  up  the  cursor 
until  it  finds  a  target  string  that  matches  the  model  that  you  have  specified. 
Use  the  DELETE  and  CTRL/U  functions  to  correct  typing  errors  in  the 
model. 

The  FINDNEXT  function  searches  for  the  next  occurrence  of  a  string  in  the 
file  that  matches  the  current  search  model.  You  can  change  the  keypad  ed- 
itor's directional  mode  between  FINDNEXT  functions  to  reverse  the  direction 
of  search. 

3.12.1    Commands  to  Change  the  Way  the  Keypad  Editor 
Searches 

You  can  use  the  SET  SEARCH  command  to  change  three  features  of  the 
keypad  editor's  searching  functions.  You  can  specify  whether  the  keypad  ed- 
itor: 

•  Searches  for  targets  that  match  the  current  model  exactly  or  generally. 

•  Places  the  cursor  on  the  first  character  of  a  target  that  matches  the  model  or 
to  the  right  of  the  last  character. 

•  Limits  a  search  to  a  page  (as  currently  defined)  or  is  allowed  to  extend  the 
search  to  the  top  or  bottom  of  the  file. 
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3.12.1.1  The  SET  SEARCH  GENERAL  Command  —  The  general  tbrni  ol  the 
command  to  specify  that  the  model  and  target  match  generally  is: 

S_ET     [SEARCH     JGENEfyAL 

After  you  enter  the  command,  the  keypad  editor  ignores  the  differences  he- 
tween  uppercase  letters  and  lowercase  letters  when  you  use  the  FIND  or 
FINDNEXT  function,  (leneral  searching  is  the  keypad  editor's  default  set- 
ting. For  a  general  search,  an  uppercase  letter  or  a  lowerca.se  letter  in  the 
model  requires  only  the  same  letter  in  the  same  position  in  the  target  string. 

The  command  has  no  effect  on  the  way  the  keypad  editor  processes  non- 
alphahetic  characters.  For  example,  for  the  model  Ten,  several  target  strings 
match  the  model  generally:  Ten,  TEN,  ten,  and  tEn  are  four  of  the  general 
matches. 

3.12.1.2  The  SET  SEARCH  EXACT  Command  —  The  general  form  of  the 
command  to  specify  that  the  model  and  target  match  exactly  is: 

SET     [SEAfyCH     DEKACT 

After  you  enter  the  command,  the  keypad  editor  depends  on  the  differences 
hetween  uppercase  letters  and  lowercase  letters  when  you  use  the  FIND  or 
FINDNEXT  function.  For  an  exact  search,  each  uppercase  letter  (the  set 
A  —  Z)  in  the  model  requires  an  uppercase  letter  in  the  same  position  in  the 
target  string.  The  lowercase  letters  must  also  match  exactly. 

The  command  has  no  effect  on  the  way  the  keypad  editor  processes  non- 
alphahetic  characters.  For  example,  for  the  model  Ten,  the  only  targets  that 
match  the  model  exactly  begin  with  an  uppercase  T  and  lowercase  en. 

3.12.1.3  The  SET  SEARCH  BEGIN  Command  —  The  general  form  of  the  com- 
mand to  move  the  cursor  to  the  beginning  of  a  target  is: 

SE.T     [SEARCH     ]  BE  G  I  N 

After  you  enter  the  command,  the  keypad  editor  locates  the  cursor  on  the  first 
character  of  a  target  string  that  matches  the  current  search  model  when  you 
use  the  FIND  or  FINDNEXT  function.  This  is  the  keypad  editor's  default 
setting. 

3.12.1.4  The  SET  SEARCH  END  Command  —  The  general  form  of  the  com- 
mand to  move  the  cursor  to  the  end  of  a  target  is: 

SET  [SEARCH  JEND 

After  you  enter  the  command,  the  keypad  editor  locates  the  cursor  just  to  the 
right  of  the  last  character  of  the  target  string  when  you  use  the  FIND  or 
FINDNEXT  function. 
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3.12.1.5    The  SET  SEARCH  BOUNDED  Command  —    1'he  general  form  of  the 
command  to  limit  a  search  is: 


SET  [SEARCH  3B0UNDED 


After  you  enter  the  command,  the  keypad  editor  limits  each  search  to  the 
page  in  which  the  cursor  is  located  when  you  use  the  FIND  or  FINDNEXT 
function.  The  editor  uses  the  current  definition  of  a  page,  either  the  default 
definition  (the  part  of  a  file  between  the  cursor  and  a  Formfeed  character)  or 
the  latest  definition  that  you  specified  with  the  SET  ENTITY  PACIE  com- 
mand. The  FIND  and  FINDNF^XT  functions  do  not  advance  or  back  up  the 
cursor  across  a  page  boundary  unless  the  cursor  starts  exactly  at  a  page 
boundary. 

Normally,  the  keypad  editor  searches  until  it  finds  a  target  string  that 
matches  the  current  model  or  until  the  cursor  reaches  the  top  or  bottom  of  the 
file.  When  you  are  editing  files  that  are  longer  than  'M)  or  40  blocks,  you  may 
find  it  useful  to  limit  the  range  of  each  search  by  using  the  SET  SEARCH 
BOUNDED  command.  However,  if  a  page  is  currently  defined  by  a  marker- 
string,  the  string  must  be  present  m  the  file  for  you  to  benefit  from  the  limited 
search. 

If  your  file  is  not  divided  into  pages  by  a  specific  marker-string,  defining  a 
line-count  for  a  page  is  the  most  convenient  way  to  limit  searches.  When  you 
define  a  page  by  line-count  and  use  the  SET  SEARCH  BOUNDED  com- 
mand, the  keypad  editor  uses  the  line-count  that  you  specified  and  searches 
only  within  that  number  of  text  lines  before  or  after  the  text  line  that  contains 
the  cursor. 


3.12.1.6  The  SET  SEARCH  UNBOUNDED  Command—  The  general  form  of  the 
command  to  allow  searching  throughout  the  file  is: 


SET  [SEARCH  JUNBOUNDED 


After  you  enter  the  command,  the  keypad  editor  extends  searches  beyond  the 
limits  of  the  page  that  contains  the  cursor  when  you  use  the  FIND  or  FIND- 
NEXT  command.  This  is  the  keypad  editor's  default  setting. 
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3.12.2    The  FIND  Function 

VIM 00  Keys:    The  PFl  key  and  the  VV:\  key  on  the  keypad. 
Vrr/J  Keys:      The  hlue  key  and  the  M  key  on  the  keypad. 

Depending'  on  directional  mode,  the  FIND  function  advances  or  hacks  up  the 
cursor  to  the  next  occurrence  ot  a  tar^iet  strinji  that  matches  the  model  you 
type.  I'se  the  SKT  SK.AHCH  command  to  specify  the  kind  of  match  you 
require,  the  final  position  of  the  cursor  when  a  search  is  successful,  and  how 
much  of  the  file  the  keypad  editor  is  to  search. 

When  you  press  the  FIND  key,  the  keypad  editor  temporarily  erases  the  top 
two  screen  lines  and  displays  the  promp'  Model  :.  The  keypad  editor  dis- 
plays each  character  of  the  model  string  ps  you  type  it.  After  you  terminate 
the  model  with  the  ADVANCT^  tunction  or  the  BACKIT  functicm.  the  keypad 
editor  moves  the  cursor  in  the  direction  you  specify.  When  the  r.eypad  editor 
.searches  far  above  or  below  the  part  of  the  file  on  the  screen,  the  keypad  editor 
may  temporarily  erase  the  top  two  screen  lines  and  display  the  message 
WORKING.  .  .  during  a  short  pause  before  repainting  the  screen.  When  the 
keypad  editor  finds  a  target  that  matches  the  model,  the  keypad  editor  re- 
paints the  screen. 

When  the  keypad  editor  finds  no  matching  string  in  an  extended  search,  the 
cursor  moves  to  the  top  of  the  file  or  the  keypad  editor  end-ot-file  symbol,  and 
the  keypad  editor  signals  the  ia'ure. 

When  the  key|)ad  editor  finds  no  matching  string  in  a  limited  search,  the 
cursor  advances  or  backs  up  to  the  nearest  page  boundary  (according  to  the 
current  definition  of  page),  and  the  keypad  editor  also  signals  the  failure. 

Examples:  The  first  example  illustrates  how  the  keypad  editor  moves  the 
cursor  in  a  successful  general  search  with  the  model  sea.  When  the  cursor's 
final  position  is  set  to  the  beginning  of  the  target,  the  keypad  editor  places  it 
on  the  5  of  sea.  When  the  cursor's  final  position  is  set  to  the  end  of  the 
target,  the  keypad  editor  places  it  just  to  the  right  of  the  a  in  sea. 


SEARCH  SF.T 
BEGI 


A  storw  forced  the  |roup  to  stOf^searchin^  for  the 


Missing  seaman. 


SEARCH  SET 
END 
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The  second  example  illustrates  how  the  keypad  editor  moves  the  cursor  in  a 
successlul  exact  search  with  the  model  Sea. 


SET  SEARCH 
BEGIN 


The  Air-Sea  Rescue  Service  plans  to  resame  the  search  tonHlrrow. 


s:t  search 

END 


The  model  can  he  up  to  HO  characters  long  and  contain  any  printing  charac- 
ters or  line  terminators. 

To  search  directly  tor  a  more  distant  occurrence  of  a  string  than  the  nearest 
one.  use  the  special  keypad  editor  tP'-hnique  tor  repeating  a  tunction.  Section 
'A.\2  descrihes  how  to  repeat  any  keypad  editor  tunction. 

The  FIND  function  is  invalid: 

1.  In  the  hackup  irn)de  when  the  cursor  is  at  the  top  of  the  file. 

2.  In  the  advance  mode  when  the  cursor  is  on  the  end-ot-file  .symbol. 
'A.    When  a  prompt  is  displayed. 


m 
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3.12.3    The  FINDNEXT  Function 

VTIOO  Key:    The  PF3  key  on  the  keypad. 
VT52  Key:      The  8  key  on  the  keypad. 

Depending  on  the  directional  mode,  the  FINDNEXT  function  advances  or 
backs  up  the  cursor  to  the  nearest  occurrence  of  a  target  string  that  matches 
the  latest  search  model  you  typed.  When  the  lieypad  editor  searches  far  above 
or  below  the  part  of  the  file  on  the  screen,  the  keypad  editor  may  temporarily 
erase  the  top  two  screen  lines  and  display  the  message  WORKING.  .  .  during 
a  short  pause  before  repainting  the  screen.  When  the  keypad  editor  finds  a 
target  that  matches  the  model,  the  keypad  editor  repaints  the  screen. 

The  FINDNEXT  function  has  the  same  effect  as  the  FIND  function.  FIND- 
NEXT  also  is  affected  by  what  you  have  specified  for  matches,  final  cursor 
location,  and  search  limits.  These  details  are  the  same  as  for  the  FIND  func- 
tion. 

The  FINDNEXT  function  is  invalid: 

1.  When  the  keypad  editor  has  no  senrch  model  (because  you  have  not  com- 
pleted a  FIND  function  yet). 

2.  In  the  backup  mode  when  the  cursor  is  at  the  top  of  the  file. 

3.  In  the  advance  mode  when  the  cur  or  is  on  the  end-of-file  symbol. 

4.  When  a  prompt  is  displayed. 

3.13    Repeating  Functions 

The  keypad  editor  provides  four  methods  for  repeating  functions: 

1.  With  either  a  VTIOO  or  a  VT52  terminal,  you  can  repeat  most  standard 
and  alternate  functions  up  to  65535  times  by  preceding  the  function  that 
you  want  to  repeat  with  the  following  sequence: 


[GOLD  imtpiJpr 

For  example,  the  following  sequence  advances  the  cursor  five  characters  to 
the  right: 


( ADVANCE  J  [  GOLD  J  5  i  CHAR  j 

The  following  sequence  makes  the  keypad  editor  advance  the  cursor  di- 
rectlv  to  the  fifth  occurrence  of  the  letter  e: 


t  GOLD  J  5  [  GOLD  )  {  FIND  J  e  I  ADVANCE  ) 
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The  functions  that  you  cannot  repeat  with  the  special  GOLD  function 
sequence  are: 

•  The  DELETE  function,  which  you  can  use  to  correct  the  integer  that 
you  type. 

•  The  CTRLA-^  function,  which  you  can  use  to  correct  the  integer  that  you 
type. 

•  The  SPECINS  function,  which  must  use  the  integer  as  the  ASCII  dec- 
imal code  for  a  character. 

You  can  cancel  a  repeat  function  entirely  by  typing  CTRL/C  or  CTRL/Z  while 
the  Repeat:  prompt  is  displayed. 

2.  With  a  VTlOO  terminal  on  which  the  autorepeat  feature  is  enabled,  you 
can  repeat  any  standard  function  by  holding  down  the  key  that  controls 
the  function  until  the  keypad  editor  has  executed  the  function  as  many 
times  as  you  want.  (The  VTlOO  User  Guide  describes  how  to  enable  and 
disable  the  autorepeat  function.) 

3.  With  a  VT52  terminal,  you  can  repeat  any  standard  function  by  simulta- 
neously pressing  the  Repeat  key  and  the  key  that  controls  the  function  you 
want  to  repeat.  Hold  down  the  keys  until  the  keypad  editor  has  executed 
the  function  as  many  times  as  you  want. 

4.  With  either  a  VTlOO  or  a  VT52  terminal,  you  can  store  and  repeatedly 
exec'  sequences  of  functions  and  commands  by  using  the  keypad  ed- 
itor's macro  feature.  The  maco  feature  is  described  in  Chapter  5. 
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Chapter  4 

Editing  or  Creating  a  File 
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This  chapter  describes  the  keypad  editor  functions  that  can  modify  a  file. 
Before  you  study  this  chapter,  you  should  understand  the  cursor  movement 
functions  described  in  Chapter  3  because  the  following  explanations  depend 
upon  them. 


4.1    Inserting  Material  into  the  File 

The  keypad  editor  provides  several  ways  for  you  to  insert  material  into  the  file 
that  you  are  editing  or  creating. 

To  insert  text,  type  the  text  on  the  keyboard  exactly  as  you  would  on  a 
standard  typewriter.  The  only  characters  that  you  cannot  insert  directly  in 
this  way  are  special  characters  such  as  the  Escape  character  or  the  Linefeed 
character.  Text  insertion  is  the  keypad  editor's  default  function. 

To  insert  an  Escape  character  or  other  special  characters  that  you  cannot  type 
directly,  such  as  the  Linefeed  character,  use  the  SPECINS  function.  The 
SPECINS  function  inserts  a  character  by  its  ASCII  code. 

To  insert  a  blank  line,  press  the  Return  key  or  use  the  OPENLINE  function. 

To  insert  the  last  character,  word,  or  line  that  y  )u  erased,  use  the  UNDEL- 
CHAR,  UNDELWORD,  and  UNDELLINE  functions.  Section  4.2  describes 
these  functions. 

To  insert  material  that  vou  have  stored  in  the  kevpad  editor's  paste  buffer, 
use  the  PASTE,  REPLACE,  and  SUBSTITUTE  functions.  Sections  4.3  and 
4.4  describe  these  functions. 

To  insert  material  that  is  in  a  different  file,  use  the  keypad  editor's  auxiliary 
input  file  features.  Chapter  5  describes  how  to  use  auxiliary  files. 

The  following  sections  describe  how  to  insert  material  by  typing  on  the  key- 
board. 
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4.1.1    Typing  on  the  Keyboard:  The  Default  Function 


The  keypad  editor's  default  function  is  insertion.  The  keypad  editor  processes 
the  output  from  each  key  on  the  keypad  and  keyboard  as  if  it  is  a  function, 
such  as  PAGP]  or  TOP,  or  part  of  a  function,  such  as  the  integer  in  ;«  repeated 
function  or  the  letters  of  a  search  model  you  are  typing.  When  the  keypad 
editor  cannot  associate  a  key  with  a  function,  the  keypad  editor  processes  the 
key  as  if  you  mean  to  insert  a  character  in  the  file. 


Therefore,  to  insert  any  valid  characters  in  the  file,  move  the  cursor  to  the 
location  where  you  want  to  make  an  insertion  and  type  the  insertion  on  the 
keyboard.  The  keypad  editor  immediately  shows  each  character  vou  insert. 


You  cannot  insert  any  characters  by  typing  on  the  keypad  or  by  using  the 
VTUK)  arrow  keys.  Also,  the  set  of  control  characters  that  you  can  directly 
insert  depends  on  the  operating  system  that  you  are  using.  However,  the 
SPECINS  function  provides  an  indirect  way  to  insert  most  of  the  control 
characters. 


4.1.2    Inserting  the  Line  Terminators 

The  most  comm(m  line  terminator  in  text  files  is  the  New  Line  terminator.  To 
insert  the  New  Line  terminator,  type  the  Return  kt>  on  the  keyboard. 


The  Linefeed,  Vertical  Tab,  and  Formfeed  line  terminators  are  less  common. 
To  insert  them,  you  must  type  the  CBL  .  key  sequence  or  SPECINS  function 
sequence  that  is  listed  in  Table  4-1.  Table  1-2  shows  the  symbols  that  the 
keypad  editor  uses  to  display  the  line  terminators  on  VT52  and  VTKK)  termi- 
nals. 


Table  4-1:     Inserting  the  Linefeed,  Vertical  Tab,  and  Formfeed  Line 
Terminators 


Line  Terminator 


Linefeed 

Vertical    lab 

Formleed 


To  Insert,  type: 


rGOLDl  1  0  (  GOLD  1  fSPECINS" 
gfRlK    or  CTRlk 

ffSLI'  or  fTRirT 
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4.1.3    inserting  Bianic  Lines:  Tiie  OPENLINE  Function 

The  OPENLINE  function  has  the  same  effect  as  typing  the  Return  key  on  the 
keyboard  followed  by  the  leftarrow  function.  The  keypad  editor  inserts  the 
New  Line  terminator  and  places  the  cursor  on  it.  Characters  that  were  origi- 
nally to  the  right  of  the  cursor  move  down  one  screen  line,  and  the  keypad 
editor  scrolls  all  lower  lines  downward. 

Example:  The  following  example  shows  a  section  of  a  file  before  and  after  two 
consecutive  OPENLINE  functions.  The  {  symbol  is  shown  only  to  clarify 
that  the  OPENLINE  function  inserts  a  line  terminator  and  that  the  keypad 
editor  places  the  cursor  on  it  (the  keypad  editor  does  not  display  the  symbol). 


BEFORE 


One  way  to  do  five  consecutive  OPENLINE  functions  is  to( 
type  the  following  se«iuence:  gOLD  5  GOLD  OPENLINEf 


AFTER 


One  way  to  do  five  consecutive  OPENLINE  functions  is  to( 
type  the  following  sequence:  g 


GOLD  5  GOLD  OPENLINE^ 


The  OPENLINE  function  is  invalid: 

1.  When  you  are  inspecting  a  file. 

2.  When  any  prompt  is  displayed. 

3.  When  earlier  insertions  have  made  the  input  file  a>  large  as  it  can  be  for 
the  space  that  the  keypad  editor  has  allocated  for  the  output  file. 

4.1.4    Inserting  Characters  by  ASCii  Code:  The  SPECINS 
Function 

The  SPECINS  function  inserts  the  character  whose  ASCII  code  (in  decimal) 
you  specii'y.  The  function  requires  a  special  GOLD  function  .sequence,  as 
follows: 

(  GOLD)  integer  fGOLD  ]  (  SPECINS  ) 

When  you  u.se  this  sequence,  the  keypad  editor  interprets  the  integer  you  type 
as  a  decimal  value,  evaluates  the  seven  low  order  bits,  and  inserts  the  corre- 
sponding ASCII  character.  Therefore,  except  for  the  Null  character,  you  can 
use  the  SPECINS  function  to  insert  any  ASCII  character.  For  example,  the 
following  sequence  inserts  the  Escape  character  (ASCII  octal  OMH.  decimal  27). 


(  QOLD  )  27  CooirD^  fSPEClNSl 


Editing  or  Creating  a  File       4-3 


Erasing  and  Restoring  Words 

The  DELWORD  function  erases  the  cursor's  current  character  and  all  other 
characters  hetween  the  cursor  and  the  befjinninji  "f  the  next  word. 

The  LINF^FEED  function  erases  all  characters  between  the  cursor  and  the  end 
of  the  preceding  word. 

The  UXDELWORD  function  restores  the  string  vou  erased  with  the  last 
DELWORD  or  LINEFEP:D  function. 

Erasing  and  Restoring  Text  Lines 

The  DELLIXE  function  erases  the  cursor's  current  character  and  all  other 
characters  between  the  cursor  and  the  beginning  of  the  next  texi  line  (that  is, 
through  the  line  terminator  for  the  current  text  line). 

The  DELEOL  function  is  similar  to  DELLINE  except  that  the  DELEOL 
function  erases  a  line  terminator  only  if  the  cursor  is  originally  on  one. 

T!  i  CTRL/l'  function  erases  all  characters  between  the  cursor  and  the  end  of 
the  preceding  text  line.  If  the  cursor  is  originally  on  a  line  terminator,  the 
CTRL/l'  function  era.ses  the  entire  preceding  text  line. 

The  I'NDELLIXE  function  restores  the  string  vou  erased  with  the  last  DEL- 
LLXE,  DELEOL,  or  CTRL/L'  function. 

4.2.1    The  Character,  Word,  and  Line  Buffers 

The  keypad  edi.or  uses  a  character  buffer,  a  word  buffer,  and  a  text  line  bufftr 
to  store  the  last  character,  word,  or  line  erasure  that  vou  make.  The  I'XDEL- 
CHAR.  rXDELVVORD.  and  I'XDELLIXE  functions  copy  the  contents  of  the 
corresponding  buffer  back  to  your  file  at  the  cursor's  location  when  you  use 
the  functif)ns. 

The  definitions  for  character,  word,  and  text  line  that  the  keypad  editor  uses 
arc  list-  d  in  Chapter  \.  The  maximum  capacities  of  the  buffers  are  as  follows: 

•  Character  buffer   -  One  line  terminator  or  AS(MI  character. 

•  VViird  buffer  —  80  characters 

•  Text  line  buffer  —  1M2  characi  rs 

When  you  start  a  keypad  editor  session,  the  buffers  are  empty.  For  each 
character,  word,  and  (ext  line  erasure  during  the  session,  the  keypad  editor 
discards  the  current  contents  of  the  cor'-esponding  buffer  and  stores  the  erased 
material. 

In  certain  cases  that  are  described  in  Section  4.4  for  the  REPLACE  and 
SUBSTITl'TE  functions,  the  keypad  editor  also  stores  the  string  that  is  re- 
moved from  y  -ir  file  in  the  word  buffer. 

Wher  you  stop  editing,  the  contents  of  the  character,  word,  and  text  line 
b'.  •■  ■•<  Bie  preserved  until  \(  i  return  to  the  RT-11  monitor  level  or  the 
RS    -IIM  or  RSX-llM-Pr>)  MCR  level. 
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4.2.3    The  DELETE  Function 

VTKX)  and  VT52  Key:  The  Delete  key  on  the  keyboard. 

The  DELETE  function  erases  the  character  at  the  cursor's  left  and  stores  it  in 
the  character  buffer  in  case  you  want  to  restore  it  to  the  file.  The  keypad 
editor  shifts  the  cursor,  the  cursor's  character,  and  any  characters  that  remain 
in  the  text  line,  moving  them  to  the  left.  The  keypad  editor  also  scrolls  lower 
lines  upward. 

Example:  The  following  example  illustrates  what  happens  when  the  DELETED 
function  erases  a  single  character  within  a  text  line. 


BEFORE:    515360775  423  695-44T  R 
800422961  )@)4  277-03T  U 
209489962  799  068-OlH  H 

AFTE,  515360775  423  695-44T  R 
800422961  i04  277-03T  U 
209489962  799  068-OlH  H 


The  following  example  illustrates  what  happens  when  the  DELETE  function 
erases  a  line  terminator. 


BEFORE     All  the  lights  are  frozen; ( 
The  cursor  blinks  blandly.} 
Boon,  I  shall  see  the  du«p.{ 

AFTER     All  the  lights  are  frozen; { 

The  cursor  blinks  blandly.goon,  I  shall  see  the  duNp.( 

When  you  are  responding  to  a  prompt,  the  DELETE  function  also  erases  the 
character  to  the  left  of  the  prompt's  cursor.  Therefore,  the  DELETE  function 
is  one  way  to  correct  a  typing  error  in  a  response.  However,  in  this  case,  you 
cannot  restore  the  characters  tha*  you  erase. 

The  DELETE  function  is  invalid: 

1.  When  you  are  inspecting  a  file. 

2.  When  the  cursor  is  at  the  top  of  the  file. 
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4.2.5    The  DELWORD  Function 

VTlOO  Key:    The  hyphen  (-)  key  on  the  keypad. 
VT52  Key:      The  9  kev  on  the  keypad. 

The  DELWORD  function  erases  the  cursor's  character  and  all  characters  to 
the  right  that  are  in  the  same  word.  The  keypad  editor  stores  the  characters  it 
erases  in  the  word  buffer  in  case  you  want  to  restore  them  to  the  file.  The 
keypad  editor  shifts  any  characters  that  remain  in  the  text  line  to  the  left.  The 
keypad  editor  also  scrolls  lower  lines  upward. 

Example:  The  following  example  shows  a  segment  of  a  file  before  and  after 
using  the  DELWORD  function  to  erase  the  part  of  a  word  that  is  to  the 
cursor's  right. 

BEFORE:     The  sponsoFs  gave  gone    26  or  27  prizes  to  adults. 
AFTER:     The  spoHsors  gave  ^6  or  27  prizes  to  adults. 

The  DELWORD  function  always  erases  at  least  one  character.  Erasing  con- 
tinues through  the  last  character  of  the  cursor's  original  word. 

The  keypad  editor  defines  a  word  as  follows: 

•  Any  line  terminator 

•  A  Horizontal  Tab  character 

•  A  string  of  spaces  at  the  beginning  of  a  text  line 

•  A  string  of  spaces  flanked  by  Horizontal  Tab  characters  or  line  terminators 

•  A  string  of  other  characters  and  the  spaces  that  follow  the  string  (you 
cannot  easily  distinguish  these  spaces  from  the  blank  the  keypad  editor 
creates  for  a  Horizontal  Tab  character,  but  note  that  a  Horizontal  Tab 
character  is  always  a  word  by  itself.) 

The  DELWORD  function  is  invalid: 
\.    When  you  are  inspecting  a  file. 

2.  When  the  cursor  is  on  the  end-of-file  symbol. 

3.  When  a  prompt  is  displayed. 
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4.2.7    The  UNDELWORD  Function 


VTlOO  Kevs: 
VT52  Kevs: 


The  PFl  key  and  the  hyphen  (-)  key  on  the  keypad. 
The  blue  key  and  the  9  key  on  the  keypad. 


Except  as  noted  below,  the  UNDELWORD  function  inserts  the  last  string  you 
erased  with  either  the  DELWORD  function  or  the  LINEFEED  function.  If 
you  used  the  DELWORD  function  to  erase  the  last  word,  the  cursor  finishes 
on  the  first  character  restored.  If  you  used  the  LINEFEED  function,  the 
cursor  finishes  to  the  right  of  the  last  character  restored.  In  both  cases,  the 
keypad  editor  shifts  characters  in  the  original  text  line  to  the  right  to  make 
room  for  the  restored  characters. 

Example:  The  following  example  a.ssumes  that  the  word  buffer  holds  the 
string  nnn-n  as  the  result  of  a  previous  LINEFEED  function.  The  example 
shows  a  segment  of  a  file  before  and  after  using  the  UNDELWORD  function. 

BEFORe     The  general  forn  of  a  Social  Security  nunber  is 

Ottii 


AFTER     The  general  forn  of  a  Social  Security  number  is 

ttf-l|i|-t8lt 

The  functions  that  restore  erasures  to  the  file  are  not  intended  primarily  for 
moving  text  to  new  locations  in  the  file,  but  you  can  use  them  for  that  pur- 
pose. For  example,  one  way  to  reverse  the  order  of  two  words  is  to  erase  one 
with  the  DELWORD  function  or  the  LINEFEED  function,  move  .le  cursor 
where  you  want  to  insert  the  erasure,  and  use  the  UNDELWORD  function. 

NOTE 

The  SUBSTITUTE  function,  and  in  .some  cases  the  REPLACE 
function,  discards  the  current  contents  of  the  word  buffer  and 
stores  the  string  it  removes  in  the  word  buffer.  The  two  func- 
tions are  described  in  Section  4.4. 

The  UNDELWORD  functicm  is  invalid: 

1.  When  you  are  inspecting  a  file. 

2.  When  the  word  buffer  is  empty  (because  vou  have  not  completed  either  a 
DELWORD  functicm  or  a  LINEFEED  function). 

•S.    When  a  prompt  is  displayed. 

4.    When  earlier  insertions  have  made  the  input  file  as  large  as  it  can  be  for 
the  space  thai  the  keypad  editor  has  allocated  for  the  output  file. 
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4.2.9    The  CTRL/U  Function 

VTIOO  and  VT52  Keys:  Hold  down  the  CTRL  key  while  you  type  the  letter  U 
on  the  keyboard. 

The  CTRL/L'  function  erases  all  characters  to  the  left  of  the  cursor's  character 
and  in  the  same  text  line.  The  keypad  editor  stores  the  characters  it  erases  in 
the  line  buffer  in  case  you  want  to  restore  them  to  the  file.  The  function 
always  erases  at  least  one  character.  If  the  cursor  starts  in  column  1,  the 
keypad  editor  erases  the  preceding  text  line  entirely  and  scrolls  upper  lines 
downward.  If  the  cursor  starts  to  the  right  of  column  1,  the  keypad  editor 
erases  the  characters  between  the  preceding  line  terminator  and  the  cursor. 

Example:  The  following  example  shows  a  segment  of  a  file  before  and  after 
using  the  CTRLA-^  function  to  erase  an  entire  line. 


BEFORE 


With  BASIC-11,  one  way  to  use  the  CHR$  function  to  send 
an  Escape  character  to  a  terminal  is 

//JB:  PLEASE  CHECK  THIS.// 
I   PRINT  CHR$(27) 


AFTER 


With  BASIC-11,  one  way  to  use  the  CHR$  function  to  send 
an  Escape  character  to  a  terminal  is 
I    PRINT  CHR$(27) 


When  you  are  responding  to  a  prompt,  the  CTRL/l'  function  era.ses  all  of  the 
characters  you  have  typed.  Therefore,  the  function  is  one  way  to  correct  a 
typing  error  in  a  response.  However,  in  this  ca.se  you  cannot  restore  the  char- 
acters that  you  erase. 

The  CTRL/U  function  is  invalid: 

1.  When  you  are  inspecting  a  file. 

2.  When  the  cursor  is  at  the  top  f)f  the  file. 
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4.2.11    The  UNDELLINE  Function 

VTIOO  Keys:    The  PFl  key  and  the  PF4  key  on  the  keypad. 

VT52  Keys:      The  blue  key  and  the  unlabeled  grey  kev  on  the  keypad. 

The  UNDELLINE  function  inserts  the  last  string  that  you  erased  with  the 
DELLLNE  function,  the  DELEOL  function,  or  the  CTRi./l^  function.  If  you 
used  the  DELLINE  function  or  the  DELEOL  function  to  erase  the  last  line, 
the  cursor  finishes  on  the  first  character  restored.  If  you  used  the  CTRLAI 
function  to  erase  the  last  line,  the  cursor  finishes  to  the  right  of  the  last 
character  restored.  In  all  three  cases,  the  keypad  editor  shifts  characters  in  the 
original  text  line  to  the  right  to  make  room  for  the  restored  characters;  and  in 
most  cases,  the  keypad  editor  also  scroll?,  the  file. 

Example:  The  following  example  assumes  that  the  line  buffer  holds  the  string 
**HIGH  SCORE  FOR  THE  SEPTEMBER  CYCLE  (beginning  with  two 
spaces)  as  a  result  of  a  previous  DELEOL  function.  The  example  shows  a 
segment  of  a  file  after  using  the  UNDELLINE  function.  The  example  also 
simulates  how  the  keypad  editor  wraps  a  line  when  a  restored  erasure  is  too 
long  to  fit  on  the  cursor's  original  screen  line. 


BEFORE 

ART  4.0 

22 

19 

.m\ 

HATH  4.0 

31 

30 

.968|H 

CHEH  €.0 

30 

12 

■n 

AFTER      ART  4.0    22  19  .864H 

MATH  4.0    31  30  .968|  »»HIGH  SCORE  FOR  THE  S 

♦  EPTEMBER  CYCLE  \ 

CHEH  6.0    30  12  .4" 

The  functions  that  restore  erasures  to  the  file  are  not  primarily  intended  for 
moving  text  to  new  locations  in  the  file,  but  you  can  use  them  for  that  pur- 
pose. For  example,  to  move  a  line  of  code  out  of  a  FORTRAN  DO-loop,  erase 
it  with  the  DELLINE  function,  move  the  cursor  to  the  l)eginning  of  a  line 
outside  the  loop,  and  use  the  UNDELLINE  function. 

The  UNDELLINE  function  is  invalid: 

1.  When  you  are  inspecting  a  file. 

2.  When  the  line  buffer  is  em;)tv  (becau.se  vou     have    not     completed    a 
DELLINE,  DELEOL,  or  (^TRL/U  functi(m). 

W.    When  a  prompt  is  displayed. 

4.    When  earlier  insertions  have  made  the  input  file  as  large  as  it  can  be  for 
the  space  that  the  keypad  editor  has  allocated  for  the  output  file. 
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4.3.1  The  Paste  Buffer 

The  keypad  editor  functions  for  moving,  holding,  and  copying  segments  of 
text  depend  on  the  special  internal  buffer  that  is  called  the  paste  buffer. 
When  you  start  a  keypad  editor  session,  the  paste  buffer  is  empty.  After  you 
use  the  CUT  or  APPEND  function,  the  paste  buffer  generally  contains  the 
material  that  you  removed  most  recently  with  the  CUT  or  APPEND  function. 
However,  you  can  empty  the  paste  buffer  by  using  the  CLEAR  PASTE  com- 
mand. The  next  section  describes  the  command  in  detail. 

When  you  stop  editing,  the  contents  of  the  paste  buffer  are  preserved  until 
vou  return  to  the  RT-11  monitor  level  or  the  RSX-llM  or  RSX-llM-PLUS 
MCR  level. 

The  size  of  the  paste  buffer  depends  on  the  operating  system  you  are  using. 
The  minimum  size  is  512  characters.  With  the  different  RT-11  monitors,  the 
actual  size  available  is  often  2000  characters  or  more,  depending  on  the  mon- 
itor you  are  using,  the  amount  of  memory  available,  and  the  size  of  the  system 
that  is  resident.  With  the  RSX-llM  or  RSX-llM-PLUS  systems,  the  actual 
size  depends  on  how  the  keypad  editor  was  installed  or  run,  and  you  can 
increase  the  paste  buffer  size  for  any  editing  session  by  following  the  proce- 
dure that  is  described  in  Section  2.3.4. 

4.3.2  Clearing  the  Paste  Buffer:  The  CLEAR  PASTE  Command 

The  general  form  of  the  command  to  clear  the  paste  buffer  is: 

CLEAR   PASTE 

The  CLF^AR  PASTP"  command  discards  the  contents  of  the  paste  buffer.  The 
command  is  especially  useful  when  you  want  to  use  the  RP^PLACE  function  to 
erase  a  multi-line  .segment  of  a  file. 

4.3.3  The  SELECT  Function 

VTlOO  and  \To2  Key:  The  period  (.)  key  on  the  keypad. 

The  SELECT  function  by  itself  has  no  visible  effect.  Until  you  use  a  function 
that  processes  the  characters  that  are  in  the  select  range,  any  function  that 
moves  the  cursor  adds  or  subtracts  characters  from  the  select  range.  All 
keypad  editor  functions,  including  inserting  and  erasing,  are  valid  after  you 
use  the  SELECT  function. 

The  way  that  the  keypad  editor  displays  the  characters  that  are  in  a  select 
range  depends  on  the  terminal,  the  form  of  the  cursor,  and  the  version  of  the 
keypad  editor  that  you  are  using.  The  following  list  summarizes  the  different 
display  methods: 

•  With  KV.D  on  a  \'T100  that  has  the  advanced  video  options  — 

For  both  the  l)lock  cursor  ■  fnd  the  underline  cursor  ( ).  KED  displays 

each  character  in  the  select  rj.nge  in  the  reverse  video  form.  For  example,  if 
the  N'TlOO  is  normally  displaying  light  characters  on  a  dark  background,  the 
characters  in  a  select  range  appear  as  dark  characters  on  a  light  back- 
ground. The  description  of  the  CUT  function  in  the  following  .section  in- 
cludes a  simulated  reverse  video  display. 
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tiifORk 


You  can  build  a  select  range  bij  wovini^  the  cursor 
forward  or  backward. 


.he  CUT  and  PAST  

unctions  work  in  the  sane  yaM  for  both  cases. 


racter  inserted  yith  the  PASTE  function. 


iUilding  a  select  range  backward  is  convenient 
when  you  decH'^  to  wove  sowe  text  or  program 
statements  that  you  have  just  typed. 


AFTER 


You  can  build  a  select  range  by  woving  the  cursor 

forward  or  backward,  [jjuilding  a  select  range  backward  is  convenient 

when  you  decide  to  nove  sone  text  or  program 

stavenents  that  you  have  just  typed. 


\V  hen  a  selection  is  too  larjje  tor  the  capacity  of  the  paste  butter,  the  keyp^^H 
editor  does  not  signal  you  until  you  use  the  VV'Y  tunction  or  the  APPK.n1) 
function.  The  most  convenient  way  to  move  or  copy  a  selection  that  is  too 
lar^'e  tor  the  paste  butter  is  to  use  the  keypad  editor's  auxiliary  input  tile  and 
auxiliary  output  file  teatures.  (Details  about  auxiliary  tiles  are  hi  Chapter  o.) 


NOTE 

^ou  can  use  the  ("IT  function  when  you  are  inspecting  a  tile, 
as  well  as  when  you  are  editing  or  creating  a  tie.  When  you  are 
inspecting  a  tile,  the  function  does  not  erase  any  material  from 
your  main  input  file,  but  does  allow  you  to  remove  a  copy  of  a 
block  <it  material  from  a  tile  and  paste  it  uito  another  file.  All  of 
the  other  teatures  described  here  are  aitive.  however. 


The  (TT  tunction  is  invalid: 

1.  When  v<iu  are  not  building  a  select  range  (because  you  have  no>.  used  the 
SKLKCr  function)  and  the  cursor  is  not  at  a  search  target. 

2.  When  'He  select  range  is  empty  (because  the  cursor  is  at  the  SKLKCT 
point ). 

H.     When  a  seJi^i    on  is  too  large  for  the  paste  buffer. 
4.    When  a  prompt  is  displayed. 
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The  PASTE  function  is  valid  ai  any  iocatidn  in  the  file,  and  you  can  use  it 
while  you  are  building-  a  select  range.  For  example,  one  way  to  place  a  .selec- 
tion at  the  beginning  ot  the  paste  buffer  contents  is  as  follows: 

1.  Move  the  cursor  to  the  beginning  of  the  selection  that  you  want  to  add  to 
the  paste  buffer. 

2.  Ise  the  SELECT  function. 

H.    .Ad\ance  the  cursor  to  the  end  of  the  selection. 

4.  I'se  the  PASTE  function  to  in.sert  the  paste  buffer  contents  after  the 
selection.  The  insertion  is  also  in  the  new  selection  you  are  building. 

").  I'se  the  (TT  function  to  store  the  new  and  larger  selection  in  the  paste 
butter. 

The  PASTE  function  is  invalid: 

1.  When  you  are  inspecting  a  file. 

2.  When  a  prompt  is  displayed. 

3.  When  earlier  insertions  have  made  the  input  file  as  large  as  it  can  be  for 
the  space  the  keypad  editor  has  allocated  for  the  output  file. 

4.4    Substituting  and  Converting  Characters  and  Strings 

Three  functions  perform  direct  substitutions  in  the  file:  REPLACE.  SL  BSTI- 
TUTE   and  CHNGCASE. 

The  REPLACE  function  substitutes  the  contents  ui  the  paste  buffer  for  a 
string  in  the  file  in  two  cases: 

L  If  you  are  building  a  select  range  and  it  is  not  empty,  the  REPLACE 
function  erases  and  discards  the  characters  in  the  select  range  and  in.serts 
the  contents  ol  the  paste  buffer. 

2.  If  you  are  not  building  a  select  range  but  the  cursor  is  at  a  search  target, 
the  REIM^.-XCE  tunction  erases  and  discards  the  target  string  and  inserts 
the  contents  of  the  paste  buffer.  In  this  case,  the  keypad  editor  stores  the 
erased  material  in  the  word  buffer.  If  the  cursor  is  at  a  valid  search  target 
and  you  are  also  building  a  select  range,  the  first  rule  (above)  takes  pre- 
cedence. 

The  srB.*^Tm'TE  function  is  a  convenient  way  to  change  several  occur- 
rences of  the  same  string  in  a  file  to  the  string  that  is  in  the  paste  buffer.  The 
keypad  editor  processes  the  SlBSniT  TE  lunction  by  doing  a  REPLACE 
(according  to  the  second  rule  listed  above)  and  then  a  FINDNEXT  in  the 
direction  you  used  Inst. 

The  (^HNCiCASE  function  changes  lowercase  letters  to  upperca.se  letters  and 
upperca.se  letters  to  lowercase  letters. 
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4.4.2    The  SUBSTITUTE  Function 

VTlOO  Keys:    The  PFl  key  and  the  Enter  key  on  the  keypad. 
VT52  Keys:      The  blue  key  and  the  Enter  key  on  the  keypad. 

Wich  the  cursor  at  a  valid  search  target,  the  keypad  editor  processes  the 
Sl^BSTITUTE  function  by  first  completing  a  REPLACE  and  then  com- 
pleting a  FINDNEXT  in  the  direction  you  specified  last.  When  you  use  the 
SUBSTITUTE  function,  the  keypad  editor  repaints  the  screen  after  it  com- 
pletes the  FINDNEXT  function.  The  SUBSTITUTE  function  is  affected  by 
the  current  settings  you  have  specified  for  exact  and  general  matches,  limited 
and  extended  searching,  and  the  definition  of  a  page. 

You  can  change  several  occurrences  of  a  string  to  whatever  is  in  the  paste 
buffer  by  repeating  the  Sl'BSTITUTE  function.  The  sequence  is 
CgoldD  integer  CIold^  C  substitute  j.  The  keypad  editor  accepts  integers  in  the 
range  from  1  to  65535. 

The  SUBSTITUTE  function  is  invalid: 

1.  When  you  are  inspecting  a  file. 

2.  When  the  cursor's  original  position  (when  you  use  the  SUBSTITUTE 
function)  is  not  on  a  valid  search  string. 

3.  When  the  keypad  editor  has  no  current  search  model  (because  you  have 
not  completed  a  FIND  function  yet). 

4.  In  the  backup  r>ode  when  the  cursor  is  at  the  top  of  the  file. 

5.  In  the  advance  mode  when  the  cursor  is  on  the  end-of-file  symbol. 

6.  When  a  prompt  is  displayed. 

7.  When  the  paste  buffer  contains  too  much  material  to  fit  in  the  file. 
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Chapter  5 

Special  Keypad  Editor  Features  for  Writers  and 
Programmers 


This  chapter  describes  the  keypad  editor's  commands  and  functions  that 
provide  special  features  for  writers  of  memos,  reports,  and  documentation  as 
well  as  for  programmers.  The  chapter  covers: 

1.  Using  auxiliary  files 

With  a  small  set  of  auxiliary  file  commands,  you  can  combine  files  that 
you  have  stored  with  different  file  names.  You  can  also  split  a  single  file 
into  separate  files  and  store  them  with  different  file  names.  These  tech- 
niques are  especially  useful  for  moving  a  block  of  material  within  your 
main  input  file  when  the  amount  of  material  is  too  large  for  the  paste 
buffer. 

2.  Using  and  changing  right  margin  settings 

Although  the  VTIOO  and  VT52  terminals  do  not  allow  you  to  set  the  right 
margin  for  a  screen  line,  you  can  achieve  that  effect  by  setting  the  right 
margin  for  an  editing  session.  You  can  reformat  text  lines  that  are  already 
in  your  file  so  that  they  fit  within  the  right  margin,  and  you  can  have  the 
keypad  editor  automatically  start  a  new  text  line  whenever  a  word  that 
you  type  reaches  past  the  right  margin. 

3.  Using  keypad  editor  macros 

When  you  want  to  repeat  a  multistep  editing  task  several  times,  you  can 
record  the  combination  of  keypad  editor  commands  and  functions  as  a 
keypad  editor  macro  and  execute  the  macro  by  using  a  single  function. 

4.  Reordering  MACRO-11  local  symbols  automatically 

When  you  use  the  keypad  editor  to  create  or  edit  source  files  for 
MACRO-11  programs,  you  can  use  a  special  keypad  editor  command  to 
reorder  local  symbols  so  that  your  programs  are  more  readable. 
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Figure  5-2  shows  the  relationship  between  the  keypad  editor  and  an  auxiliary 
input  file.  You  specify  the  auxiliary  input  file  by  using  the  OPEN  INPUT 
command.  After  you  enter  the  command,  you  can  copy  material  from  the 
auxiliary  input  file  into  your  main  input  file  at  the  cursor's  location.  When 
you  copy  an  entire  auxiliary  input  file,  you  will  have  combined  the  auxiliary 
input  file  with  your  main  input  file. 


KED/K52 


Auxiliary 
Input  File 

— c 


Main 
Input  File 


Main 
Output  File 


Figure  5-2:    Relationship  Between  the  Keypad  Editor  and  an  Auxiliary 
Input  File 


Figure  5-3  shows  the  full  relationship  between  the  keypad  editor  and  the  main 
and  auxiliary  files.  You  can  use  an  auxiliary  input  file  and  an  auxiliary  output 
file  at  the  same  time,  combining  material  from  the  auxiliary  input  file  with 
your  main  input  file,  and  copying  parts  of  the  file  you  are  editing  to  an 
auxiliary  output  file.  You  can  use  only  one  auxiliary  input  file  and  one  auxi- 
liary output  file  at  a  time,  but  by  changing  them  during  an  editing  session, 
you  can  combine  and  split  several  files  in  many  ways. 

You  can  also  create  an  auxiliary  output  file,  store  it.  and  then,  during  the 
same  editing  session,  u.se  the  file  as  an  auxiliary  input  file.  This  technique  is 
especially  useful  for  moving  a  block  of  material  within  your  main  input  file 
when  the  amount  of  material  is  too  large  for  the  paste  buffer. 


Special  Keypad  Editor  Features  for  Writers  and  Programmers       5-3 


5.1.3    Auxiliary  Output  Files 

Although  the  keypad  editor  protects  you  from  changir.g  a  file  while  you  are 
inspecting  it,  you  can  open  an  auxiliary  output  file,  copy  parts  of  the  file  you 
are  inspecting  to  the  auxiliary  output  file,  and  close  it  without  any  effect  on 
the  original  file. 

You  can  extract  a  selection  from  a  file,  modify  the  selection  for  another  pur- 
pose, and  print  it. 

During  any  keypad  editor  session,  the  general  procedure  for  using  auxiliary 
output  files  is  as  follows. 


1.  Start  the  keypad  editor  and  complete  a  file  specification  string. 

2.  Use  the  OPEN  OUTPUT  command  to  open  an  auxiliary  output  file. 

3.  Use  the  WRITE  command  to  copy  material  from  your  main  input  file  to 
the  auxiliary  output  file. 


4.  Use  the  CLOSE  command  to  close  and  save  the  auxiliary  output  file. 

5.  Terminate  the  keypad  editor  session  with  the  EXIT  or  QUIT  command. 


The  four  commands  for  auxiliary  output  files  are  OPEN  OUTPUT,  WRITE, 
CLOSE,  and  PURGE. 


5.1.3.1    The  OPEN  OUTPUT  Command  —  The  general  form  of  the  command  to 
open  an  auxiliary  output  file  is: 

[OPEN  DQLJTPUT  fiU'-specificatton 


The  keypad  editor  accepts  any  valid  file  specification.  The  default  output 
device  is  your  system's  default  storage  device.  If  another  file  with  the  same 
specification  already  exists,  the  keypad  editor  signals  you  and  loads  the  fol- 
lowing help  message: 


Auxiliary  o  li  I  p  u  t  file  e  k  i  s  t  s  -  Replace  (  N'  •  N  )  "^ 


You  can  cancel  the  entire  command;  or  you  can  have  the  keypad  editor 
proce.ss  the  command,  erase  the  existing  file,  and  replace  it  with  the  new 
output  you  select. 

Only  one  auxiliary  (»utput  file  can  be  open  at  a  time.  When  you  open  a  second 
auxiliary  output  file  and  one  is  already  open,  the  keypad  editor  automatically 
closes  the  first  one.  (If  you  close  an  auxiliary  output  file  that  is  empty,  the  file 
is  saved  but  it  has  zero  blocks  of  data.) 
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5.1.3.4  The  PURGE  Command  —  The  form  of  the  command  to  discard  the 
contents  of  an  auxihary  output  file  is: 

PURGE 

When  an  auxihary  output  file  is  open,  the  PURGE  command  deletes  the  file 
and  its  contents  and  cancels  the  last  OPP'X  OITPIT  command.  Thus,  all 
data  copied  to  that  file  are  lost.  No  files  are  erased  or  stored.  If  you  want  to 
use  an  auxiliary  output  file  after  the  keypad  editor  completes  the  PURGE 
operation,  start  over  with  a  new  OPEN  OUTPIT  command. 

5.1.4    Auxiliary  Input  Files 

You  can  open  an  auxiliary  input  file  at  any  time  while  you  are  editin^r  or 
creating  a  different  file.  You  can.  for  example,  collect  small  files  or  parts  of 
larger  files  and  insert  them  in  the  main  file  you  are  editing.  Since  inserting 
material  from  an  auxiliary  input  file  means  modifying  your  main  file,  this 
feature  is  not  available  while  you  are  inspecting  a  file.  You  can  only  use  it 
after  you  have  started  a  keypad  editor  session  to  edit  or  create  a  file. 

The  general  procedure  for  using  auxiliary  input  files  is  as  follows. 

1.  Start   the  keypad  editor  and   complete  the  file  specification  string  for 
editing  or  creating  a  file. 

2.  L'se  the  OPEN  INPUT  command  to  open  an  auxiliary  input  tile. 

3.  Use  the  SKIP  command  to  skip  past  text  lines  or  pages  in  the  auxiliary 
input  file  that  you  do  not  want  to  insert  in  your  main  file. 

4.  Use  the  INCT.UDE  command  to  copy  text  lines  or  pages  of  the  auxiliary 
input  file  to  your  main  I'ile. 

5.  Use  the  OPEN  INPUT  command  to  close  an  auxiliary  input  file  and  open 
another  one. 

5.1.4.1  The  OPEN  INPUT  Command  —  The  general  form  of  the  command  to 
open  an  auxiliary  input  file  is: 

[OPEN    ]I_NPUT  filr-spcdfirntinn 

The  keypad  editor  accepts  any  valid  file  specification.  The  default  input 
device  is  your  system's  default  storage  device. 

Only  one  auxiliary  input  file  can  he  open  at  a  time.  Each  ♦"  >e  you  f)pen  an 
auxiliary  input  file,  the  keypad  editor  closes  the  one  is  open  (if  any). 

However,  you  can  open  the  same  auxiliary  input  file  .lany  times  as  you  like 
while  you  are  using  the  keypad  editor.  You  can  als<  jse  any  auxiliary  output 
file  as  an  auxiliary  input  tile  in  the  same  session  after  you  have  closed  it  with 
the  (T.OSE  command.  (The  CLOSE,  command  has  no  effect  on  an  open 
auxiliary  input  tile.) 

You  do  not  need  to  explicitly  close  an  auxiliary  input  file.  Any  method  you  use 
to  terminate  the  keypad  editor  session  automatically  closes  it. 

When  you  have  opened  an  auxiliary  input  file,  you  can  either  skip  material  in 
It  or  copv  material  from  it  to  the  main  file  you  are  editing. 
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The  form  INTLl'DK  REST  copies  all  -li  the  text  lines  that  remain  in  the 
auxiliary  input  file,  After  inserting  the  last  text  line,  the  keypad  editor  auto- 
matically closes  the  auxiliary  input  file. 

The  form  IXCLl'DE  intcmr  FACES  uses  the  current  definition  of  a  page  and 
copies  as  many  pages  from  the  auxiliary  input  file  as  you  specify.  The  keypad 
editor  accepts  integers  in  the  range  from  1  to  BooiJo. 

The  form  INC^U'DE  integer  LINES  uses  the  keypad  editor's  standard  defini- 
tion of  a  text  line  and  copies  as  many  text  lines  from  the  auxiliary  input  file  as 
you  specify.  The  ke\pad  editor  accepts  integers  in  the  range  from  1  toHooii"). 


5.1.5    Example:  Using  Auxiliary  Files  to  Move  a  Large  Amount  of 
Material 

The  keypad  edit.)r  paste  buffer  is  usually  large  enough  t((  allow  you  to  move 
material  around  within  your  files.  However,  in  sf)me  cases  you  are  likel\  to 
want  to  move  larger  amounts  of  material  than  the  paste  buffer  can  hold.  This 
section  describes  one  method  for  using  the  keypad  editor  auxiliary  file  fea- 
tures to  do  this.  The  primary  purpose  of  this  example  is  to  give  you  a  complete 
model  of  a  typical  auxiliary  file  process  that  you  can  try  itnmediately  with  any 
of  your  text  files. 

The  general  method  is  as  follows: 

1.  Open  an  auxiliary  output  file. 

The  example  u-cs  the  auxiliary  file  name  Al'X.TXT.  but  you  can  use  any 
file  name  that  you  like. 

2.  Copy  ii :<i;-"rial  from  your  main  input  file  to  the  auxiliary  output  file  and 
close  •'>'  auxiliarv  output  file. 

The  example  copies  three  pages  of   material,   bu*  you  can  change  that 
amount  to  whatever  you  like. 

'A.     Erase  the  material  from  your  main  input  file. 

4.     Move  the  cursor  to  where  vou  want  the  material  to  appear. 

The  example  backs  the  cursor  up  by  15(1  lines.  [)ut  you  can  use  any  cursor 
movement  function  that  is  appropriate  for  your  file. 

.").    Copy  the  material  from  the  auxiliary  file  you  created  to  your  main  input 
file. 

Opening  the  Auxiliary  Output  Fi!e 

To  open  the  auxiliary  output  tile  ACX.TXT.  use  the  following  sequence: 


f  COMMAND    nPFN  OUTPUT  AUX.TXTt  INTtW  : 
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Moving  the  Cursor  to  the  Material's  New  Location 

To  back  the  cursor  up  by  150  lines  use  the  special  GOLD  sequence  for 
repeating  a  function: 


[    BACKUP  )(  GOLD)  15(:i(BLINE1 


Copying  in  the  Material  at  the  New  Location 


To  copy  the  auxiliary  file  material  back  into  the  main  input  file,  first  open  the 
auxiliary  file  as  an  auxiliary  input  file.  Use  the  following  sequence: 


(  COMMAND)  nPFN    INPUT   AUX.  TXT  CENTER  ) 

To  copy  all  of  the  auxiliary  file  use  the  following  command: 


(  COMMAND)  rNPI    I  IDF   REST!  ENTE^ 

At  this  point,  you  have  finished  the  process.  You  do  not  need  to  close  the 
auxiliary  file  because  the  keypad  editor  does  so  automatically.  However,  you 
may  want  to  delete  the  auxiliary  file  since  you  are  probably  finished  using  it. 
When  you  finish  the  editing  session  and  returi  to  the  RT-ll  monitor  level,  the 
MCR  level  in  RSX  systems,  or  the  IAS  DCL  or  MCR  levels,  you  can  delete  the  I 
file  with  the  appropriate  commands  for  your  operating  system. 

5.2    Using  and  Changing  Right  Margin  Settings 

The  keypad  editor  has  a  set  of  features  for  refining  the  overall  format  of 
paragraphs  and  lines  of  text.  Memos,  letters,  and  program  documentation  are 
examples  of  the  kinds  of  files  whose  format  you  may  want  to  change  in  order 
to  present  clear,  attractive,  and  easy  to  read  text.  With  the  keypad  editor's 
right  margin  features,  you  can: 

•  Use  the  SET  WRAP  command  to  adjust  the  right  margin. 

•  Use  the  SET  WRAP  command  to  set  the  keypad  editor  to  automatically 
start  a  new  text  line  when  you  type  a  word  that  reaches  past  the  right 
margin  (the  word  wrap  feature). 

•  Use  the  FILL  command  to  reformat  a  selection  within  your  file  so  that  each 
text  line  contains  only  as  many  full  words  as  can  fit  within  the  right  margin. 

•  Use  ♦^he  SET  NOWRAF  command  to  stop  the  word  wrap  feature. 

The  following  sections  describe  the  right  margin  features,  which  work  the 
same  on  all  operating  systems,  in  detail. 
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The  following  examples  illustrate  how  the  keypad  editor  displays  the  same 
text  when  you  type  the  text  in  two  cases: 

1.  Before  entering  a  SET  WRAP  command  —  that  is,  before  enabling  the 
word -wrap  feature. 

2.  After  using  the  SET  WRAP  command  to  specify  a  right  margin  of  32. 

The  scale  above  each  example  shows  the  lengths  of  the  lines  that  the  keypad 
editor  displays.  In  the  second  example,  the  |  symbol  is  shown  only  to  clarify 
that  the  keypad  editor  automatically  inserts  the  New  Line  line  terminator 
when  a  word  that  is  being  entered  reaches  past  the  right  margin. 

Example  1:  For  this  example,  start  the  keypad  editor  in  one  of  the  following 
ways: 

•  For  RT-11  systems 

Return  to  the  monitor  level.  If  you  are  using  a  VTICX)  terminal,  set  the 
screen  idth  to  80  columns.  Start  the  keypad  editor  with  the  RUN  or  R 
command. 

•  For  RSX-llM  and  RSX-llM-PLUS  systems 

Exit  your  current  task  with  the  CTRL/Z  command.  If  you  are  using  a  VTlOO 
terminal,  set  the  screen  width  to  80  columns.  Start  the  keypad  editor  with 
the  RUN  $KED  or  RUN  $K52  command  or  the  direct  call  with  the  task 
name  KED  or  K52. 

•  For  IAS  systems 

Return  to  the  MCR  >  or  PDS  >  prompt.  If  you  are  using  a  VTlOO  terminal,  set 
the  screen  width  to  80  columns.  If  you  are  using  MCR,  start  the  keypad 
editor  by  means  of  a  direct  call  with  the  task  name  KED  or  K52.  If  you  are 
using  DCL  (PDS),  start  the  keypad  editor  with  the  PDS  EDIT/KED  or 
EDIT/K52  command. 


Now,  type  the  text  line  that  is  below  the  scale.  Do  not  press  the  Return  key  or 
enter  any  other  line  terminator  while  you  are  typing.  (The  following  example 
simulates  how  your  screen  will  look,  but  is  not  an  exact  image.) 


CHARACTERS    1 


0  2|0 

IN  I  I  I  I 


30 


410 


S|0 


J^ 


111 


The  SET  URAP  conwnd  sets  KED  to  use  the  special  word-wrap  featu 

♦  re.  yhen  you  type  a  word  that  reaches  past  the  right  nargin,  K 

♦  ED  autoNdtically  starts  a  new  text  line. 
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at  the  top  of  the  select  range,  the  keypad  editor  extends  short  text  lines  by 
moving  words  from  lower  text  lines  and  breaks  long  text  lines  by  inserting  the 
New  Line  terminator  after  the  last  full  word  that  fits  within  the  right  margin. 

With  VTIOO  terminals,  you  can  use  either  the  FILL  command  or  the  FILL 
function.  They  have  the  same  effects.  The  default  right  margin  depends  on 
the  screen  width: 

•  The  default  is  column  78  when  the  screen  width  is  80. 

•  The  default  is  column  130  when  the  screen  width  is  132. 
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With  VT52  terminals,  only  the  FILL  command  is  available.  The  default  right 
margin  is  always  column  78. 

Examples:  The  following  example  shows  the  same  text  before  and  after  using 
the  FILL  command.  Assume  that  the  right  margin  has  been  set  to  column  58. 
The  scale  above  the  example  shows  the  lengths  of  lines  that  the  keypad  editor 
displays.  The  \  symbol  is  shown  only  to  clarify  the  locations  of  line  termina- 
tors before  and  after  the  keypad  editor  reformats  the  select  range.  (The  "be- 
fore" part  of  the  example  simulates  your  screen,  but  is  not  an  exact  image.) 


[CHARACTERS     1|0 

!  I  M  I  Im  I  M 


310 


Mill!. 


610 

I :  I  !l  I 


BEFORE 


I  he  FILL  connand  refornats  the  text  with  in  a  select  range  so  t 
hat  no  word  reaches  past  the 


argin. 
ihe  function  is  especial 1h  convenient  when  hou  need  to  use  a  ri 


Hmj 


ardin  that  is  less  that  Hour  screen  width. 


AFTER 


The  FILL  coNnand  reformats  the  text  with  in  a  select^ 
range  so  that  no  word  reaches  past  the  right  margin.  The^ 
function  15  especially  convenient  when  you  need  to  use  at 
right  nargin  that  is  less  that  your  screen  widthj 


The  keypad  editor  processes  the  FILL  command  in  different  ways  when  the 
last  character  within  the  select  range  is  the  New  Line  terminator  and  other- 
wise. 

When  the  last  character  in  the  select  range  is  the  New  Line  terminator,  the 
keypad  editor  rclormats  the  select  range  and  then  attaches  the  text  line  that 
was  below  the  select  range  to  the  last  reformatted  text  line.  However,  the 
keypad  editor  does  not  reformat  the  attached  line,  and  therefore  in  this  case  a 
wrapped  line  is  often  the  result.  The  following  example  illustrates  the  effect. 
You  can  avoid  creating  the  wrapped  line  by  building  the  select  range  so  that 
the  bottom  is  at  the  end,  not  at  the  beginning,  of  a  text  line. 
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Before:  (the  ^   symbol  shows  tlic  locations  of  the  original  New  Line  termina- 
tors) 


CHARACTERS     110  2|0 

I  M  !  h  I  I  I  I  !  !  I  M  i  I  I  I  I  I  I 


310 


410 


510 


610 


I  M  '  I  M  M  I  I  i  I  '  I  !:  !  M  I  I  I  I  ■  I  ! 


I      ! 


iJ 


BEFORE 


.e  FILL  coNMand  reforMats  the  text  yith  in  a  select  range  so  t 
hat  no  word  reaches  past  the< 


rgin., 
ihe  function  is  especial  1m  convenient  when  uou  need  to  use  a  ri 


n 


in  that  IS  less  thai  uour  screen  uidth. 


II  •••■•  I  iiiiiiiiii  11 


y 

After:  (assume  that  the  right  margin  has  been  set  to  column  58;  the  l  symbol 
shows  the  new  locations  of  the  Carriage  Return -Linefeed  terminators) 


AFTER:     The  FILL  coMMand  reforMats  the  text  with  in  a  select? 

range  so  that  no  word  reaches  past  the  right  narjin.  The? 
function  IS  especially  convenient  when  you  need  to  use  af 

right  nargin  that  is  less  that  your  screen  width.  Q 

♦ 

NOTE 

DKiITAL's  document  formatting  program  RUNOFT  and  sim- 
'  ilar  programs  require  files  with  special  commands  that  must  be 
located  at  the  beginnings  of  text  lines.  When  you  use  the  FILL 
function  to  reformat  lines  in  a  file  of  this  sort,  be  careful  to 
build  select  ranges  that  do  not  include  any  of  the  special  com- 
mands. F'or  example,  if  you  reformat  a  select  range  that  in- 
cludes a  RUNOFF  command,  the  keypad  editor  is  likely  to 
move  the  RUNOFF  command  .so  that  the  RUNOFF  program 
cannot  detect  and  process  it. 

The  FILL  command  affects  some  special  characters  and  line  terminators  in 
special  ways,  as  noted  in  the  following  summary: 

\.    A  New  Line  terminator  is  inserted  immediately  before  each  Vertical  Tab 
character  and  Formfeed  character. 

2.    A  single  space  replaces  any  string  of  the  following  characters: 

•  Spaces 

•  Horizontal  Tab  characters 

•  Carriage  Return  characters  and  [linefeed  characters  when  they  stand 
alone  as  well  ^s  when  they  are  together.  Therefore,  if  the  paragraphs  in 
your  file  are  separated  by  blank  lines,  the  FILL  command  will  join  the 
paragraphs.  To  avoid  having  the  paragraphs  joined,  process  each  one 
separately  or  use  the  Vertical  Tab  or  Formfeed  characters  to  separate 
them. 
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5.3    Using  Keypad  Editor  IVIacros 

A  keypad  editor  macro  is  a  combination  of  keypad  editor  commands  and 
functions  that  you  have  stored.  The  following  examples  describe  three  simple 
combinations  of  functions.  Each  combination  would  have  exactly  the  same 
effect  as  one  of  the  functions  that  are  described  in  earlier  chapters. 


1.    (  RETURN  ifT^fti??^  as  the  equivalent  of  tne  OPENLINE  function 

When  you  press  the  Return  key  and  then  the  leftarrow  key,  the  effect  is 
the  same  as  when  you  use  the  OPENLINE  function.  The  keypad  editor 
inserts  the  New  Line  line  terminator  when  you  press  the  Return  key  and 
moves  the  cursor  to  the  terminator  when  you  press  the  leftarrow  key. 

If  you  store  the  (  return  )(  Leftarrow)  combination  as  a  macro,  the  keypad 
editor  will  execute  the  combination  each  time  you  use  the  X  function.  In 
this  case,  your  macro  will  do  exactly  what  the  OPENLINE  function  does. 


2.    fGOLDl  1 G  fBJjND  as  the  equivalent  of  the  SECTION  function 

When  you  use  the  combination,  the  keypad  editor  advances  or  backs  up 
the  cursor  by  16  text  lines.  If  the  default  definition  of  a  section  is  your 
current  definition,  the  effect  of  the  combination  is  the  same  as  when  you 
use  the  SECTION  function. 

If  you  store  the  combination  as  a  keypad  editor  macro,  the  X  function  will 
do  exactly  what  the  SECTION  function  does,  as  long  as  a  section  is 
defined  as  16  text  lines. 


3.    ( REPLACE  )Lf!ndnext  )  as  the  equivalent  of  the  SUBSTITUTE  function 

When  you  use  the  combination,  the  keypad  editor  substitutes  the  contents 
of  the  paste  buffer  for  a  string  in  your  file  in  two  cases: 

a.  When  you  have  built  a  select  range,  the  keypad  editor  replaces  the 
selisct  range. 

b.  When  the  cursor  is  at  a  search  target  and  you  have  not  built  a  select 
range,  the  keypad  editor  replaces  the  search  target. 

In  the  second  case,  the  effect  of  the  combination  is  the  same  as  when  you 
use  the  SUBSTITUTE  function. 

If  you  store  the  combination  as  a  keypad  editor  macro,  the  X  function  will 
do  exactly  what  the  SUBSTITUTE  function  does. 

After  you  have  stored  a  combination  of  commands  and  functions,  you  can 
execute  the  entire  combination  by  using  the  X  function.  To  use  the  X  func- 
tion, the  alternate  functitm  of  the  X  key  on  your  keyboard,  press  the  GOLD 
key  on  the  keypad  first,  then  the  X  key. 

Keypad  editor  macros  work  the  same  with  VT52  and  VTl(X)  terminals  on  the 
RT  11,  KSX  IIM.  RSX   IIM  PLUS,  and  IAS  operating  .systems.  | 
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The  LEARN  command  erases  the  last  macro  you  specified.  The  keypad  editor 
then  stores  a  new  macro  by  recording  each  keyboard  and  keypad  key  that  you 
press  until  you  use  the  X  function  or  the  S  function  to  end  the  macro. 

The  S  function  ends  the  macro,  but  the  keypad  editor  does  not  execute  the 
macro  until  you  use  the  X  function. 

The  X  function  executes  the  macro.  If  you  use  the  X  function  while  you  are 
recording  a  macro,  the  t\  i..  tion  ends  the  macro  and  executes  it  immediately. 

The  following  sections  describe  in  detail  the  macro  command,  the  related 
functions,  and  several  ful!  examples  of  macros  that  you  may  find  useful. 

5.3.1    Recording  a  Macro:  The  LEARN  Command 

You  can  use  the  LEARN  command  to  record  a  combination  of  functions  and 
commands  as  a  keypad  editor  macro  at  any  time  during  a  keypad  editor 
session.  After  you  enter  the  LF^ARN  command,  the  keypad  editor  erases  your 
last  macro  and  then  records  the  next  functions  and  commands  you  use  and 
the  keyboard  keys  you  type  until  you  use  the  S  or  X  functions. 

The  general  form  of  the  command  to  store  a  sequence  of  functions  and  com- 
mands is: 


LEARN 


The  only  functions  and  commands  that  you  cannot  include  within  a  macro 
are: 

1.  The  S  functi'  n. 

2.  The  X  function. 

3.  The  LEARN  Command. 

The  keypad  editor  uses  a  special  macro  buffer  which  can  hold  up  to  127 
characters  to  record  a  macro.  F^ach  keyboard  key  generates  one  character  and 
each  arrow  key  and  keypad  key  generates  three  characters.  When  you  are 
recording  a  macro  and  you  press  a  key  that  exceeds  the  ca|)acity  of  the  macro 
buffer  or  use  a  function  that  the  keypad  editor  cannot  execute,  the  keypad 
editor  signals  you  that  it  is  erasing  all  of  the  commands  and  functions  that 
have  been  recorded.  However,  since  the  keypad  editor  also  executes  and  dis- 
plays the  effect  of  each  successful  command  and  function  as  you  use  it.  you 
can  always  identify  the  function  or  command  that  filled  the  macro  buffer.  The 
macro  buffer  is  large  enough  for  mo.st  macros,  and  therefore  you  may  never 
have  to  consider  the  number  of  bytes  that  a  function  or  command  requires. 
However,  the  following  suggestions  will  help  you  lo  reduce  the  size  of  any 
macro  you  want  to  use: 

1.  I'se  the  abbreviated  forms  of  commands  and  omit  any  optional  command 
words.  Each  character  in  a  command  requires  one  byte  in  the  macro 
buffer,  as  summarized  in  Table  5  1  below. 
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2.  Specify  a  search  model  and  the  keypad  editor  settin},'s.  such  as  screen 
width  and  page  definitions,  before  entering  the  LF^ARN  command.  Within 
the  macro,  use  the  HXDXEXT  function  instead  of  the  FIND  function 
whenever  possible. 

3.  If  the  macro  is  to  insert  characters  that  you  type,  store  them  in  the  paste 
buffer  before  you  enter  the  LEARN  command,  and  then  use  the  PASTE 
function  within  the  macro. 

4.  Use  the  ADVANCE  and  BACK  IT  functions  within  a  macro  only  when 
they  are  needed. 

5.  Use  the  special  GOLD  sequence  for  repeating  three  or  more  consecutive 
functions.  For  example,  the  sequence   golxT'  3  iTeftarrow'',  requires  less  macro 

buffer  space  than  the  sequence  ,  "LeftafTo^r ; ,'  Ueflarrow"")  ri-eftarrow  j. 

Table  5-1  summarizes  the  number  of  bytes  each  function  and  command  re- 
quires when  you  use  it  within  a  keypad  editor  macro.  For  each  command,  the 
table  shows  the  number  of  bytes  required  for  the  shortest  valid  abbreviation. 

Table  5-1 :    Macro  Buffer  Capacity  for  the  Keypad  Editor  Commands  and 
Functions 


Commands  and  Functions 

Bytes  Required  in  Buffer 

.Arrow  tunctions 

■.\ 

Characters  on  the  main  keyboard,  ex- 

1 

cept  as  noted  t)elow 

Commands 

9  plus  1  hyte  per  character  typed 

•'(  for  (K)IJ)  phis  1   hyte  per  digit   in  the 

(  GOLD  )  intp^pr 

intefjer 

Keypad  functions 

.'<;  therefore,  the  lower  functior  on  each  kev 

requires  a  total  of  6  bytes 

Section  5.3.4  describes  several  typical  macros  in  detail. 


5.3.2    Terminating  a  Keypad  Editor  Macro:  The  S  Function 

VTlOO  Keys:    The  PFl  key  on  the  keypad  and  the  S  key  on  the  keyboard. 
VT52  Keys:      The  blue  key  on  the  keypad  and  the  S  key  on  the  keyboard. 

Use  the  S  function  to  end  a  macro  without  immediately  executing  the*  macro. 
After  you  use  the  function,  you  can  use  any  keypad  editor  commands  or 
functions.  However,  the  LEARN  command  will  erase  the  macro  you  have  just 
recorded. 

Examples:  See  Section  5.3.4. 

Errors:  The  S  function  is  valid  only  when  yoti  are  recording  a  macro. 
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5.3.3  Executing  a  Keypad  Editor  Macro:  The  X  Function 

VTIOO  Keys:    The  PFl  key  on  the  keypad  and  the  X  key  on  the  keyboard. 
VT52  Keys:      The  blue  key  on  the  keypad  and  the  X  key  on  the  keyboard. 

Use  the  X  function  to  execute  the  hitest  macro  that  you  have  recorded.  If  you 
use  the  function  while  you  are  recording  a  new  macro,  the  keypad  editor 
terminates  the  macrc/  and  execute,-,  it  immediately. 

Examples:  See  Section  5.3.4. 

Errors:  The  X  function  is  valid  only  when  the  macro  buffer  contains  a  macro. 

5.3.4  Examples  of  Keypad  Editor  IV!acros 

This  section  lists  several  typical  keypad  editor  macros  that  you  may  find 
useful  or  that  you  may  want  to  modify  for  the  special  work  that  you  do.  Each 
example  includes  several  special  documentation  conventions  that  you  should 
be  familiar  with. 

Each  example  has  three  parts: 

1.  The  commands  and  functions  that  you  must  use  before  entering  the 
LEARN  command.  For  example,  when  you  plan  to  use  the  FINDNEXT 
function  within  a  macro,  in  most  cases  you  will  want  to  specify  a  search 
model  before  you  begin  to  define  your  macro.  To  do  that,  you  would  use 
the  FIND  function  before  you  enter  the  LEARN  command. 

2.  The  LEARN  command  and  the  combination  of  commands  and  functioi.s 
that  you  want  the  keyp)ad  editor  to  store  as  a  macro. 

8.  The  cf)mmands  and  functions  that  would  normally  follow  the  S  or  X 
function  that  you  use  to  end  the  macro. 

Each  example  is  described  as  a  series  of  steps,  with  at  least  one  command  or 
function  in  each  step.  The  descriptions  use  the  following  special  symbols  and 
conventions: 

L    The  (JOLD  function  is  printed  only  in  the  following  cases: 

•  When  the  (iOLD  integer  sequence  is  used  to  repeat  a  function. 

•  When  the  SFECTNS  function  is  used. 


For  example,  the  string  f  advance  '  gold")  3  Tword  ]  means  "use  the 
ADVANCE  function  and  the  GOLD  sequence  to  repeat  the  WORD  func- 
tion three  times."  The  string  goTd  27  specins;  means  "use  the  SFECTNS 
function  to  insert  the  Escape  character." 

2.  Strings  of  letters,  digits,  and  other  characters  that  are  typed  on  the  key- 
board are  not  enclosed.  For  example,  the  string  find  J  0  912  3 1  advance^ 
means  "use  the  FIND  function  to  search  forward  for  the  string  09123." 
The  string  (Command j  0 P E N  OUTPUT  rvEPOryT.  1  0 3 L  ent|r )  means  "use 
the  OPEN  OUTPUT  command  to  open  an  auxiliary  output  file  named 
REPORT.  103." 
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5.3.4.1     Removing  the  Text  in  REM  Statements  from  a  BASIC-11  Program  — 

You  can  decrease  the  size  ol  a  BASIC  1 1  pro^^am  by  removing  the  comments 
that  are  in  the  program.  One  recommendation  is  to  remove  only  the  text, 
however,  because  transfer  statements,  such  as  the  (10  TO  statement,  may 
specify  the  Hne  number  of  a  REM  statement.  You  can  remove  only  the  text  of 
a  series  of  REM  statements  by  executing  the  following  sequence  of  keypad 
editor  commands  and  functions.  The  example  assumes  that  the  BASIC-11 
program  does  not  contain  compound  statements  in  the  following  form: 


10    REM    This     15 


a    com  m  e  u  I 


pry  I  NT    ;;$ 


To  set  the  keypad  editor  for  exact  search  matching,  use 

(  COMMAND  iqpT    SEARCH   EXACTT  ENTER  j 


•  To  specify  that  the  keypad  editor  is  to  place  the  cursor  after  the  target  in  a 
successful  search,  use 

[  COMMAND  ,  SET   SEARCH   END'   ENTER': 


•  To  specify  the  string  REM  as  the  search  model,  use 

I  FINDi  REM  fADVANCE  j 


•  To  start  storing  the  combination  of  commands,  use 

["command'; learn \  enter". 


•  To  erase  the  text  of  each  REM  statement  but  leave  the  line  number  and  the 
keyword  REM,  use 

(  DELEOL  j(    FINDNEirr] 


•  To  end  the  combination  without  executing  it,  use  the  S  function. 

•  To^  execute  the  combination,  use  the  X  function.  The  cf)mbination 
[ADVANCE  ^goLD^  )<  removes  remarks  that  are  to  the  right  of  the  cursor  and 
below  it.  and  the  combination  backuFjCgold";  x  removes  remarks  that  are  to 
the  left  of  the  cursor  and  above  it. 


5.3.4.2  Extracting  Addresses  That  Contain  a  Given  ZIP  Code  —  When  y(tu 
have  a  mailing  list  with  a  .systematic  lormat  tor  each  address,  you  may  be  able 
to  use  a  set  of  the  keypad  editor  functions  and  commands  to  extract  the 
addresses  that  contain  a  certain  ZIP  code.  The  following  secjuence  ot  com- 
mands and  functions  assumes  that  the  mailing  list  has  two  features  in  partic- 
ular: 

•  A  blank  line  before  the  first  line  of  each  address. 

•  No  five-digit  number  except  the  ZIP  code  in  any  address. 
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The  fact  that  a  blank  line  precedes  each  address  means  that  each  address  is 
preceded  by  two  consecutive  New  Line  terminators.  The  following  macro  uses 
this  fact  to  guarantee  that  an  address  with  any  number  of  lines  can  be  ex- 
tracted. 

•  To  define  a  page  in  terms  of  a  marker  string  that  has  two  New  Line  termina- 
tors, use 

f  COMMAND  J  SFT   PAGE  "   (RH)  (RET)   "  (  ENTER  ) 

•  To  open  the  auxiliary  output  file  named  ADDOUT.LST  for  the  addresses 
th,  *  you  extract,  use 

(  commandIopen  output  addout  .  lst:"enter1 

•  To  specify  the  model  ZIP  code  99999,  use  one  of  the  following: 

(  FIND  )  9  9399  nADVANCEj 


(  FIND)  99  999!    BACKUP  ] 

•  To  start  recording  a  combination  of  commands  and  functions,  use 

(  COMMAND~j  LEARN  (  ENTER  ; 

•  To  find  the  next  address  that  contains  the  ZIP  code  you  have  specified,  use 

rADVANCE  ](~FINDNhXT   ) 

•  To  move  the  cursor  back  to  the  beginning  of  the  address,  use 

{  backup"; (  pageH 

•  To  write  the  address  to  the  auxiliary  output  file,  use 

{.'command  ■  WRITE    1    PAGE  C'eNTeF, 

•  To  end  the  combination  without  immediately  executing  it.  use  the  S  func- 
tion. 

•  To  execute  the  macro,  use  the  X  function. 

You  can  use  this  macro  to  extract  addresses  for  more  than  one  ZIP  code  by 
using  the  FIND  function  again  to  specify  a  different  model  ZIP  code. 


5.3.4.3  Moving  the  Cursor  to  the  End  of  a  Word  —  The  WORD  function  moves 
the  cursor  only  to  the  first  character  in  a  word.  However,  in  some  cases  you 
may  want  to  change  the  endings  of  several  different  words.  For  example,  you 
may  want  to  change  words  from  the  singular  to  the  plural. 

In  normal  text,  most  of  the  words  that  the  keypad  editor  detects  end  with  one 
or  more  spaces,  and  you  can  record  a  macro  that  uses  this  fact  to  move  the 
cursor  directly  to  the  first  space  that  follows  the  printing  characters  in  a  word. 
One  example  of  such  a  macro  follows: 

•  To  specify  a  space  as  a  search  model,  use 

(  find)(sp)(  advance") 

•  To  start  storing  a  combination  of  commands  and  functions,  use 

(COMMANDll  FftryNflNTpn 
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•  To  move  the  cursor  to  the  beginning  of  a  word  and  then  to  the  first  space  in 
the  word,  use 

(  WORD^fFINDNEXT  ) 

•  To  end  the  sequence  and  execute  it  immediately,  use  the  X  function. 

This  macro  moves  the  cursor  to  the  end  of  a  word  (mly  when  the  word  has 
traihng  spaces.  The  macro  skips  other  words  entirely.  For  example,  the  macro 
skips  words  that  end  with  line  terminators  and  Horizontal  Tab  characters. 

5.3.4.4  Erasing  Spaces  from  the  End  of  a  Text  Line  —  When  you  create  a  file 
from  card  images,  each  line  in  the  file  may  have  several  spaces  immediately 
preceding  the  line  terminator.  The  following  sequence  assumes  that  the  New 
Line  terminator  is  at  the  end  of  each  line  and  erases  any  spaces  that  are 
between  the  last  printing  character  and  the  terminator. 

•  To  start  storing  a  sequence  of  commands  and  functions,  use 

C  COMt^/KNCT,  LEARN  i   ENTER"; 

•  To  r>earch  for  a  text  line  that  has  one  or  more  trailing  spaces,  use 

(  FINDjfSPl  ®ET)  (  ADVANCE  j 

•  To  move  the  cursor  to  the  first  trailing  space  in  the  line,  use 

(  BACKUP  ,1  i   WORD  )  ('  FIND  )  (SP)  (  ADVANCE  J 

•  To  erase  all  trailing  spaces,  use 

(  deleol") 

•  To  end  the  sequence  and  execute  it  immediatelv.  use  the  X  function. 


5.3.4.5  Reformatting  Paragraphs:  The  FILL  Function  or  Command  —  Section 
5.2.5  describes  how  to  use  the  VT52  FILL  function  and  the  VTIOO  FILL 
command  to  reformat  the  text  lines  in  a  select  range.  When  the  keypad  editor 
finishes  processing  the  select  range,  no  new  text  line  reaches  beyond  the  right 
margin  you  are  using. 

When  you  want  to  reformat  the  text  lines  that  are  in  separate  paragraphs,  you 
need  to  create  a  select  range  for  each  paragraph  and  then  u.se  the  fIlL 
command  or  function.  The  following  example  describes  a  macro  to  reformat 
paragraphs  in  a  file  when  the  paragraphs  are  separated  by  two  con.secutive 
New  Line  terminators  that  are  followed  by  five  spaces  at  the  beginning  of  the 
first  line.  The  macro  assumes  that  the  u.ser  will  advance,  not  back  up,  through 
the  file  from  paragraph  to  paragraph. 

•  To  specify  two  consecutive  New  Line  terminators  as  the  search  model,  use 

CfMD®  ®  (ZdvancU 

•  To  start  recording  the  combination  of  commands  and  functions,  use 

("command"  )  L  F  ft  ry  N  i  ENTE ^ ' 

•  To  move  the  cursor  to  the  first  printing  character  in  the  paragraph,  use 

(  GOLD  )  7  (  Rightarrow  ) 


Special  Keypad  Editor  Features  for  Writers  and  Programmers       5-23 


•  To  build  a  select  range  that  includes  the  text  lines  that  are  in  the  para- 
graph, use 

r  SELECT  J  (    FINDNEXT  ] 

•  To  reformat  the  text  lines  in  the  paragraph,  use  one  of  the  following: 
With  a  VTIOO  terminal  —  JjID 

With  a  VT52  terminal  —  iI^ommand  j  f  i  ll  Cjjjljgj 

•  To  end  the  combination  without  executing  it,  use  the  S  function. 

•  To  execute  the  combination,  use  the  X  function. 


5.4    Reordering  MACRO-11  Local  Symbols:  The  LOCAL 
Command 

digital's  standards  for  MACRO-11  programs  specify  that  local  symbols 
within  each  local  symbol  block  (LSB)  start  with  10$  and  have  an  increment  of 
10.  The  keypad  editor  LOCAL  command  automatically  reorders  local  symbols 
to  satisfy  the  DIGITAL  recommendations  or  the  different  standards  that  you 
specify. 

The  new  local  symbols  that  the  keypad  editor  generates  start  with  the  symbol 
10$  by  default  or  with  the  starting  value  that  you  specify  as  part  of  the 
LOCAL  command.  After  the  first  local  symbol,  the  keypad  editor  generates 
other  local  symbols  with  a  default  increment  of  10  or  with  the  increment  that 
you  specify  as  part  of  the  command. 

For  full  descriptions  of  local  symbol  blocks,  refer  to  the  MACRO-ll  Reference 
Manual. 

The  full  form  of  the  command  to  reorder  MACRO-11  local  symbols  is: 

_L£CAL  latartirifi   valui'lincrrment  ]  ] 

The  starting  value  and  increment  that  you  specify  must  be  integers  in  the 
range  1-65535. 

The  keypad  editor  restricts  your  use  of  the  local  symbol  reordering  feature  in 
the  following  ways. 

1.  If  the  LSB  is  divided  into  pages  bv  Formfeed  characters,  the  cursor  must 
be  located  at  or  above  the  first  Formfeed  within  the  LSB  when  you  enter 
the  LOCAL  command.  If  the  cursor  is  not  at  a  valid  location,  the  keypad 
editor  displays  the  message  i.'al  1  d  start  of  LSB  not  found. 

2.  7'he  keypad  editor  detects  and  changes  only  the  local  symbols  that  are 
defined  within  the  LSB  in  the  following  form: 

<Line  terminatorxZero  or  more  separators  ^.Jnteger><$><:> 
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The  separators  that  the  keypad  echtor  accepts  are  the  space  and  the  Hori- 
zontal Tab.  The  keypad  editor  chanfies  all  symbols  whose  detinitions  are 
in  thi>  torni  and  also  all  of  the  references  to  those  symbols  that  it  I'an 
detect,  includin^i  references  that  are  within  comments.  The  definition  of  a 
local  symbol  reference  that  the  keypad  editor  uses  is: 

<non-Hadix-r)()  character  ■•  inte^'er  ><.S^> 

■  I    The  keypad  editor  detects  onl\  the  l.SHs  that  are  defined  a.-,  follows: 

•  If  an  LSB  begins  with  the  FA'.AHl.  l.SH  direiti\e  and  ends  with  either 
the  DSAHL  LSH  (hrective  or  another  KNABL  I-SH  directive,  the 
keypad  editor  reorder>  all  of  the  local  s\nil)ols  that  are  properlv  defined 
with  the  LSB. 

•  It  an  LSB  is  not  defined  with  an  initial  .L.XABL  LSB  directive,  the 
keypad  editor  reorders  the  local  s\nibol>  that  are  properly  defined  be- 
tween a  non-local  >\inbol  definition  and  the  next  occurrence  of  One  of 
the  following,': 

A  non-local  svmbol  definition. 

A  .KNABL  LSB  directive. 

A    DSABL  '.SB  directive 

MACP.O  11  accepts  other  LSB  definition>.  but  the  keypad  editor  cannot 
detect  them.  For  example,  the  keypad  editor  cannot  detect  the  .PSKCT  direc- 
tive as  an  LSB  terminator,  and  therefore  the  keypad  editor  will  continue  to 
chanjie  local  svmbol>  l)clow  the  .PSKCT  directive  until  it  detects  one  of  the 
features  described  abo\f. 

^  ou  can  tombine  LSB>  that  use  the  same  local  symboU  b\-  first  reordering 
each  LSB  with  a  local  symbol  start iny  value  that  does  not  overlap  the  other 
LSBs.  then  combining  the  LSBs,  and  finally  reordering  the  combination.  For 
exi..nple.  to  reorder  the  local  symbols  within  iwo  LSBs.  use  a  procedure  such 
a?*  the  following: 

L     Reorder  one  of  the  LSBn  with  the  L()('.-\L  joou  command. 
2.     Combme  the  LSBs  by  using  the  (IT  ami  I'ASl  K  functions. 
'A.    Reorder  the  combined  LSB  with  the  LOCAL  Ui  command. 


5.5    Features  for  Editing  Programs  in  Structured  Languages 

The  keypad  editor's  structured  tab  features  provide  programtners  who  use 
structured  languages  with  convenient  ways  to  indent  statements  by  different 
amounts.  The  ,  'atures  are  especially  useful  when  you  want  to  show  the 
nesting  level  (A  programming  structures  and  statements. 
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The  SET   lARS 


coin  til 


iiiid  sets  the  keypad  editor  for  the  hasit'  amount  ol 


indentation  that  you  want  the  keypad  echtor  to  insert  when  sou  ty|)e  the  Tab 
key  under  certain  conditions.  Alter  you  set  the  basic  indentation,  use  the 
keypad  editor's  three  keyboard  (unctions  tor  structured  tabs  to  align,  extend, 
and  decrease  the  total  amount  of  indentation  that  the  keypaci  editor  is  to 
fjenerate  each  time  you  press  the  Tab  key.  The  three  functions  and  a  summary 


o 


f  the 


ir  eftects  are 


1.     A  (the  alternate  function  of  the  A  kev 


Sets  the  total  indentation  to 


align  with  the  column  number  oi  the  cursor's  current  locat 


on. 


ion 


2.     I)  (the  alternate  function  of  the  1)  key)        Decreases  the  total  indentat 
by  the  basic  amount  that  you  specitied  in  your  last  SK'l'TABS  command. 

'A.     E  (the  alternate  function  ot  the  E  keyi       Extends  the  total  indentation  by 
the  basic  amount  that  you  specitied  in  your  last   TABS  command. 

The  SET  XOT.ARS  command  disables  the  structured  tab  features. 

The  TABS  AD.Il'ST  command  adjusts  the  indentation  ot  each  line  in  a  select 
range  or  optimizes  the  number  of  Tab  characters  and  s[)aces  at  the  beginning 
of  a  line,  depending  on  the  argument  that  you  specify. 


5.5.1    Enabling  Structured  Tabs:  The  SET  TABS  Command 

The  general  form  of  the  command  to  enable  structured  tabs  is: 

SET    TABSC    mdrntl 

indent  is  the  basic  amount  of  indentation  you  specify  and  must  ^e  an  integer 
in  the  range  1-  ;<27«i7.  When  you  omit  an  indent  value,  the  keypad  editor  uses 
the  default  value  4. 

When  you  specify  an  indent  value,  the  keypad  editor  uses  the  value  to  calcu- 
late the  total  amount  of  indentation  you  want.  'I'he  structured  tab  functions 
A.  I),  and  E  adjust  an  internal  counter  that  is  called  the  ieiel  counter.  The 
keypad  editor  calculates  the  total  indentation  to  ireate  when  you  insert  a 
Horizontal  Tab  character  as  follows: 


Tdtal   indent         Irnl   rntr    *    hasir    indent 

After  you  enable  structured  tabs  and  press  the  Tan  key.  the  kevpad  editor 
provides  the  total  indentation  unless  there  are  spaces  or  Horizontal  Tab  char- 
acters to  the  left  of  the  cursor  in  the  cursor's  current  line.  If  a  space  or  a 
Hori;<(>ntal  Tab  character  is  to  the  left  of  the  cursor,  the  keypad  editor 
responds  to  th(    Tab  key  as  if  structured  tabs  were  disabled. 

Thf  keypad  editor  provides  the  total  indentation  by  first  inserting  a  Hori- 
zontal Tab  character  for  each  set  of  eight  spaces  in  the  total  inden*  »n  and 
then  by  inserting  spaces  as  required  to  match  the  total  indenlati'    . 
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Each  time  vou  enter  a  SET  TABS  command,  the  keypad  editor  resets  the 
level  counter  to  1.  The  I)  function  decreases  the  level  counter  by  1.  The  E 
function  increases  the  level  counter  by  1.  When  the  column  number  of  the 
cursor's  current  location  is  evenly  divisible  by  the  basic  indentation  value,  the 
A  function  sets  the  level  counter  equal  to  the  quotient   )f  the  division. 


5.5.2    Disabling  Structured  Tabs:  The  SET  NOTABS  Command 

The  general  form  of  the  command  to  disable  structured  tabs  is: 


SET    NOTABS 


The  command  disables  all  structured  tab  features,  including  the  TABS  AD- 
JUST command.  After  the  SET  NOTABS  command,  the  keypad  editor  pro- 
cesses the  Tab  character  in  the  normal  vva> .  as  a  single  AS(TI  character. 


5.5.3    Aligning  Structured  Tabs  to  the  Cursor:  The  A  Function 

VTlOO  Keys:    The  PFl  key  on  the  keypad  and  the  A  key  on  the  keyboard. 
VT52  Keys:       The  blue  key  on  the  keypad  and  the  A  key  on  the  keyboard. 

The  A  function  is  disabled  until  you  enable  structured  tabs  by  entering  the 
SET  TABS  command.  When  structured  tabs  are  enabled,  the  A  function 
causes  the  keypad  editor  to  calculate  a  value  for  the  level  counter  from  the 
column  number  of  cursor's  current  location.  The  functicm  is  especially  useful 
when  you  want  to  insert  new  programming  statements  within  a  group  oi 
statements  that  are  already  indented. 

The  keypad  editor  uses  the  following  procedure  to  calculate  the  value  for  the 
level  couriter: 

1.  The  keypad  editor  divides  the  column  number  of  the  cursor's  current 
location  by  the  l)asic  indentation  value  that  you  specified  with  your  last 
Sprr  TABS  command. 

For  example,  with  a  basic  indentation  value  of '>  and  the  cursor  at  column 
21,  type  the  A  function.  The  keypad  editor  calculates  the  levf  ounter  as 
4.  If  you  then  move  the  cursor  to  the  beginning  of  a  line  and  pros  the  Tab 
key,  the  keypad  editor  inserts  two  Horizontal  Tab  characters  and  four 
spaces  to  create  the  total  indentation  of  20.  The  keypad  editor  then  leaves 
the  cur.sor  at  column  21.  ready  for  you  to  insert  material. 

2.  When  the  cursor  is  not  at  column  1  and  the  column  number  is  not  evenly 
divisible  by  the  basic  indentation  thdt  you  have  specified,  the  keypad 
editor  signals  an  error  and  ignores  the  new  value  for  the  level  counter.  In 
this  case,  an  existing  level  counter  value  is  not  changed.  If  you  u.se  the 
HELP  function  in  this  case,  the  keypad  editor  displays  the  message: 

TAB   I  ii  d  e  n  t   u  a  1  u  e  ui  r  o  ri  3   for   alia  n 
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For  example,  with  a  basic  indentation  value  of  6  and  with  the  cursor  at 
column  11,  the  keypad  editor  calculates  a  level  counter  that  is  between  1 
and  2,  ignores  the  calculated  value,  and  retains  the  previous  level  counter 
value. 

Example:  See  Section  5.5.7. 

5.5.4  Decreasing  the  Level  Counter:  The  D  Function 

VTIOO  Keys:    The  PFl  key  on  the  keypad  and  the  D  key  on  the  keyboard. 
VT52  Keys:      The  blue  key  on  the  keypad  and  the  D  key  on  the  keyboard. 

The  D  function  is  disabled  until  you  enable  stn  ctured  tabs  by  entering  the 
SET  TABS  command.  When  structured  tabs  are  enabled,  use  the  D  function 
to  subtract  1  from  the  level  counter.  One  common  use  for  the  function  is  to 
decrease  the  total  indentation  at  the  beginning  of  a  statement  line  so  that 
your  program  format  reflects  the  nesting  level  of  structures  within  the  pro- 
gram. 

Example:  See  Section  5.5.7. 

5.5.5  Extending  the  Level  Counter:  The  E  Function 

VTlOO  Keys:    The  PFl  key  on  the  keypad  and  the  E  key  on  the  keyboard. 
VT52  Keys:      The  blue  key  on  the  keypad  and  the  E  key  on  the  keyboard. 

The  E  function  is  disabled  until  you  enable  structured  tabs  by  entering  the 
SET  TABS  command.  When  structured  tabs  are  enabled,  use  the  E  function 
to  add  1  to  the  level  counter.  One  common  use  for  the  function  is  to  increase 
the  total  indentation  at  the  beginning  of  a  statement  line  so  that  your  pro- 
gram format  reflects  the  nesting  level  of  structures  within  the  program. 

Example:  See  Section  5.5.7. 

5.5.6  Adjusting  Structured  Tabs:  The  TABS  ADJUST  Command 

With  structured  tabs  enabled,  the  TABS  ADJUST  command  allows  you  to: 

1.  Adjust  the  indentation  of  a  multiline  segment  of  a  flle. 

2.  Reduce  to  a  minimum  the  number  of  spaces  and  tab  characters  at  the 
beginning  of  indented  lines. 

Therefore,  if  you  increase  or  decrease  the  logical  nesting  level  of  a  part  of  a 
program,  you  can  with  one  command  also  increase  or  decrease  the  amount  of 
indentation  at  the  beginning  of  a  program  line.  And  if  the  size  of  your  program 
is  critical,  you  can  ensure  that  the  indentations  are  taking  as  little  space  as 
possible. 

The  full  form  of  the  command  ':>  adjust  structured  tabs  is: 

[TABS   ]  ADJUST   C  [  h|  ]  numhvr-uf-triclsl 
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The  number  of  levels  must  be  an  intege)-  in  the  range  -50  to  +50  and  deter- 
mines the  amount  that  the  current  indentation  is  to  be  changed.  Structured 
tabs  must  be  enabled  and  the  segment  of  your  file  that  you  want  to  adjust 
must  be  in  a  select  range. 

If  the  number  of  levels  is  zero  or  if  you  omit  the  value,  the  editor  processes  the 
TABS  ADJUST  command  as  follows: 

1.  Within  the  select  range,  the  editor  finds  each  text  line  that  begins  with  a 
string  of  spaces  or  tab  characters. 

2.  The  editor  then  retains  the  text  line's  indentation  but  replaces  the  string 
with  the  most  efficient  combination  of  spaces  and  tab  characters. 

If  the  number  of  levels  is  less  than  or  greater  than  zero,  the  keypad  editor 
processes  the  TABS  ADJUST  command  as  follows: 

1.  The  editor  finds  the  first  complete  text  line  in  the  select  range.  Then  the 
editor  completes  the  following  steps  for  each  text  line  that  is  in  the  select 
range. 

2.  Within  the  text  line,  the  editor  finds  the  end  of  the  first  occurrence  of: 
A  string  of  spaces. 
A  string  of  tab  characters. 

•  A  combination  of  spaces  and  tab  characters. 

3.  With  cursor  at  the  end  of  the  string  of  spaces  or  tabs,  the  editor  calculates 
the  level  counter  for  the  cursor's  position.  The  process  is  the  same  as  for 
the  A  function  that  aligns  the  level  counter  to  the  cursor's  position. 

4.  The  editor  adds  or  subtracts  the  number  of  levels  that  you  specified  in  the 
TABS  ADJUST  command. 

5.  The  editor  adjusts  the  text  line  to  the  proper  indentation  and  finds  the 
beginning  of  the  next  text  line  in  the  select  range. 

At  the  end  of  the  process,  the  cursor  is  located  at  the  end  of  the  select  range. 

When  you  adjust  the  indentation  of  a  select  range,  the  editor  cannot  maintain 
the  position  of  comments  that  are  to  the  right  of  executable  statements  in  the 
select  range.  However,  if  the  current  increment  with  which  you  enabled  struc- 
tured tabs  is  a  multiple  of  8  and  the  comments  are  preceded  by  Tab  charac- 
ters, the  comments  will  remain  aligned  when  you  adjust  the  indentation. 

The  TABS  ADJUST  command  is  invalid  when  you  are  inspecting  a  file. 


Special  Keypad  Editor  Features  for  Writers  and  Programmers       5-29 


5.5.7    Examples  of  Structured  Tab  Features 

This  section  provides  examples  of  the  keypad  editor  structured  tab  features  in 
the  context  of  a  short  section  of  a  FORTRAN  program.  By  creating  a  new  file 
and  following  the  instructions  for  each  step,  you  can  see  the  processes  that 
take  place. 

1.    Enable  structured  tabs  and  set  the  basic  indentation  to  four  spaces  by 
entering  the  SET  TABS  4  command.  Use  the  following  sequence: 


(  GOLD  ) (  command" I  SET    TABS   a  f  ENTER 


2.  With  the  cursor  at  column  1,  press  the  Tab  key  where  the  ®  symbol 
appears  and  type  the  following  FORTRAN  statement: 

®  DO    100  NUM   =    START  .   FINISH  © 

The  keypad  editor  indents  the  statement  to  column  5  with  4  spaces  be- 
cause the  basic  indentation  is  4  and  the  level  counter  is  1.  The  indentation 
is  created  with  spaces  because  it  is  not  large  enough  to  permit  any  Tab 
characters  to  be  used. 

3.  Increase  the  level  counter  to  2  by  using  the  E  function.  Use  the  following 
sequence: 

rGOLD  )  CT] 

4.  With  the  cursor  at  column  1,  press  the  Tab  key  and  type  the  statements  as 
shown  (the  programming  error  with  the  Sl'M  =  0  statement  will  be  cor- 
rected in  a  later  step): 

®  SUM  =   0  (RfTl 

®  SUM   =   SUM  +  ATyRAY    (  NUM  1  © 

100  C[A|C0NTINUE  (SH) 

The  keypad  editor  indents  the  first  two  statements  to  column  9  with  a  Tab 
character  (equivalent  to  8  spaces)  because  the  level  counter  is  now  2.  Each 
indentation  is  created  with  a  Tab  character  because  the  keypad  editor 
calculates  that  the  Tab  character  will  have  the  same  effect  as  8  spaces. 

5.  Decrease  the  indentation  by  using  the  D  function.  Use  the  following  se- 
quence: 

(  GOLDinPl 

6.  With  the  cursor  at  column  1,  press  the  Tab  key  and  type  the  following 
statements  as  shown: 

CSi  TYPE   #  .   SUM 
®  END 

The  keypad  editor  indents  the  statements  to  column  '>  by  inserting  4 
spaces  because  the  level  counter  is  now  1. 


# 
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7.    Your  FORTRAN  statements  now  look  'ike  the  following  illustration. 


ICHARACTERS     1]0  210  3|0 

LmiJil  I  i  I.LU.^;j.,LLilLLL:_lL.LlJLiLl L 


410  510  610 

J  ill-L   ■    !  1    i    I   I    i:    l!  !    i    I    '  ;   i   M    !   I 


DO  100  NUH  =  START,  FINISH 

SUH  =  0 

SUH  =  SUM  +  ARRftY  (NUH) 
100    CONTINUE 
TYPE  *,   SUH 
END 


To  indent  the  six  statements  4  additional  spaces,  put  the  statements  into 
8  select  range  and  enter  the  TABS  ADJUST  +1  command.  With  the 
cursor  at  column  1  of  the  DO  statement,  use  the  following  sequence: 


rSELECTirBOfTOMlf  COMMAND  iTflRR   ADJUST    +  1  ClHiM] 

The  keypad  editor  increases  each  indentation  by  4  columns  by  calculating 
and  inserting  the  most  efficient  combination  of  Tab  characters  and  spac>^s 
for  each  htatement. 

8.  The  SUM  ^  0  statement  is  inside  the  DO  loop  by  mistake.  Fix  the  error  by 
moving  the  statement  above  the  DO  statement.  The  six  statements  should 
look  like  the  following  illustration; 


CHARACTERS     IjO 

1 1  1 1  III  I !  i    i  :^ 


210  3i0  410  510 

LaiiIij±:^_iii±L  Mill  !1lL.±ii[_lli^±l 


810 


100 


SUH  =  0 
DO  100  NUH  =  START,  FINISH 

SUH  =  SUH  +  ARRAY  (NUH) 

CONTINUE 
TYPE  «,  SUH 
END 


9.  Decrease  the  indentation  of  ihe  SUM  ----  0  statement.  Put  the  statement  in 
a  .select  range  and  enter  the  TABS  ADJUST  1  command.  With  the  cursor 
at  column  1  of  the  SUM      0  statement,  u.se  the  following  sequence: 


SELECT  ¥  ADVAiMCTK  BLINE  IT  COMMAND  j  TftRR   ADJUST    -  1  rENTEP") 
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10.  To  insert  a  statement  in  the  DO  loop  and  align  it  with  the  other  state- 
ments that  are  in  the  loop,  use  the  A  function  to  set  the  level  counter 
properly.  With  the  cursor  on  the  C  ot  the  word  COXTINrp^.  use  the 
following  sequence: 


(  GOLD^'  I'X^i 

11.  Move  the  cursor  to  the  heginning  of  the  1(X)  CONTIXrE  statement  and 
create  an  open  line  tor  the  new  statement  by  using  the  following  sequence: 


(      backup"^:  (  BLINE  ]  (OPENLINEJ 

The  six  statements  should  look  like  the  following  illustration: 


ICHARACTERS     1|0 


I 


310 


^ii. 


.T 


510 


I  I 


610 


SUH  =  0 

DO  100  NUH  =  START,  FINISH 
SUM  =  SUH  +  ARRAY  (NUH) 


100      CONTINUE 
TYPE  *,   SUH 
END 

12.  Type  the  following  statement. 

®  IF    (  ARRAY ( NUM  )    .  LT .    0  )    TYPE   ♦  •     L o m   "  a  1 u e    a  I       .NUM 

The  keypad  editor  indents  the  statement  to  column  I'A.  The  total  indenta- 
tion is  the  equivalent  of  12  spacer;  CA  times  4)  because  the  A  function  set 
the  level  counter  to  M  and  the  basic  indentation  is  4. 
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Appendix 

PDP-11  Keypad  Editor  iVIessages 


This  appendix  lists  all  of  the  messages  that  the  keypad  editor  can  display. 
The  listing  is  arranged  according  to  the  first  letter  and  later  characters  in  each 
message.  The  prompts  and  informative  messages  the  keypad  editor  displays, 
such  as  the  Command:  prompt  and  the  WORKING.  .  .  message,  are  also 
listed. 

Each  error  message  is  documented  in  the  following  manner: 

1.  The  error  message  appears  in  boldface. 

2.  Beneath  the  message  are  two  columns.  The  left-hand  column  describes 
the  conditions  that  caused  the  message  to  be  generated.  The  right-hand 
column  contains  information  about  correcting  the  error  condition. 

The  keypad  editor  displays  messages  in  three  general  formats: 

1.  Command  level  messages  in  the  form 
?KED-Severity  Code-Text 

2.  HELP  function  messages  centered  on  the  bottom  screen  line. 

3.  Prompts  and  informative  messages. 

Sections  A.l,  A. 2,  and  A. 3  summarize  the  ways  the  keypad  editor  uses  the 
Command  String  Interpreter  and  HELP  function  messages.  Section  A  4  ex- 
plains the  procedure  to  follow  if  one  of  the  keypad  editor's  messages  about 
nonrecoverable  conditions  appear.  Section  A. 5  provides  suggestions  that  ap- 
ply to  any  of  the  keypad  editor's  messages  that  an  output  file  is  full.  Section 
A. 6  is  the  full  listing  of  messages. 

A.l    Messages  at  the  Command  String  Level 

Command  level  messages  have  the  following  general  form: 
?KED-Severity  Code-Text 


A-I 


KED  and  K52  both  use  the  same  messages.  The  messages  usually  appear  if 
your  response  to  the  keypad  editor  prompt  contains  or  causes  an  error.  The 
two  severity  codes  that  you  may  see  and  their  meanings  are: 


Severity  Code 
F 

W 


Me'=»ning 

A  fatal  error;  the  ksypad  editor  returns  either  to  the  system 
level  or  to  the  keypad  editor  prompt. 

A  warning;  the  keypad  editor  con^^inues  executing  unless  you 
choose  to  stop  it. 


A. 2     HELP  Function  Messages 

When  the  keypad  editor  is  displaying  a  file  on  the  terminal  screen,  it  signals 
whenever  it  cannot  process  a  function  or  command  in  the  normal  way.  The 
keypad  editor's  normal  signal  is  to  ring  the  bell  on  the  terminal.  With  a  VTlOO 
you  can  also  set  the  keypad  editor  for  quiet  signalling  by  using  the  SET 
OUIET  command.  The  command  is  explained  in  Chapter  3. 

When  the  keypad  editor  signals  you  in  either  way,  you  may  be  able  to  see 
immediately  the  cause  of  the  signal  by  inspecting  the  cursor's  position  or  the 
changes  that  have  been  displayed  on  your  screen.  You  can  also  see  a  one-line 
message  that  explains  the  signal  by  using  the  HELP  function.  The  function  is 
explained  in  Chapter  3. 

A. 3     Prompts  and  Informative  Messages 

When  the  keypad  editor  is  displaying  a  file  on  the  terminal  screen,  it  also 
displays  prompts  and  informative  messages  by  displaying  text  on  the  first 
line.  The  keypad  editor  automatically  repaints  the  screen  when  it  completes 
the  process  that  is  related  to  the  prompt  or  informative  message.  For  example, 
when  you  move  the  cursor  the  full  length  of  a  very  long  file,  the  keypad  editor 
may  temporarily  display  the  message  WORK  ING.  .  .  on  the  top  screen  line. 
When  the  cursor  reaches  its  target,  the  keypad  editor  removes  the  message 
and  repaints  the  screen. 

A. 4     Messages  for  Nonrecoverable  Conditions 

Some  of  the  messages  displayed  by  the  keypad  editor  identify  nonrecoverable 
conditions.  Digital  Equipment  Corporation  uses  these  messages  to  diagnose 
the  keypad  editor  malfunctions.  Whenever  a  nonrecoverable  condition  arises, 
use  the  following  procedure. 

1.  As  accurately  as  possible,  write  down  the  functions  and  commands  you 
used  before  the  message  appeared. 

2.  Save  the  programs  or  files  you  were  editing. 

3.  Obtain  a  new  copy  of  the  keypad  editor  from  your  distribution  kit  and  try 
to  duplicate  the  functions  and  commands  that  caused  the  message. 
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4.  If  the  message  reoccurs,  check  your  hardware  or  find  someone  to  check  it 
for  you. 

5.  If  the  problem  persists,  consult  someone  in  your  area  who  is  very  familiar 
with  the  keypad  editor. 

6.  If  you  qualify  to  receive  a  written  reply  under  DIGITAL'S  Software  Per- 
formance Report  (SPR)  service,  follow  the  directions  on  the  SPR  form. 


A.5     Messages  When  an  Output  File  Is  Full  on  RT-11 

With  RT-11  the  keypad  editor  can  display  several  messages  when  the  file  you 
are  editing  or  creating  is  too  large  to  allow  more  insertions  during  the  current 
editing  session.  This  section  includes  suggestions  that  may  be  useful  when 
this  condition  arises 

The  keypad  editor  uses  the  normal  RT-11  procedures  when  it  opens  an  output 
file.  The  output  file  is  opened  first  to  obtain  one-half  of  the  largest  block  of 
free  space  on  the  output  volume,  or  the  second  largest  block  of  free  space, 
whichever  is  larger.  After  that  step,  if  the  output  file  space  is  not  large  enough 
for  the  input  file  you  specify,  the  keypad  editor  uses  the  largest  block  of  space 
available  on  the  output  volume. 

In  almost  all  cases  the  output  file  will  be  large  enough  for  your  input  file  and 
insertions.  However,  you  may  exceed  its  capacity,  especially  if  you  add  the 
contents  of  several  auxiliary  input  files  to  the  main  input  file.  If  that  should 
occur,  try  one  of  the  following  suggestions. 

1.  Exit  and  Start  a  New  Session 

When  you  use  the  EXIT  command,  the  keypad  editor  saves  the  output  file 
and  prompts  you  for  another  CSI  file  specification  string.  If  you  then  begin 
another  session  and  edit  the  file  you  just  created,  the  keypad  editor  opens 
a  new  output  file.  In  most  cases,  the  new  output  file  will  be  large  enough  to 
hold  the  additi(ms  you  want  to  make. 

This  suggestion  may  not  be  effective  if  the  output  volume  you  are  using  is 
almost  full  or  if  free  space  on  it  is  not  consolidated.  (Use  the  RT-11 
SQUEEZE  command  to  consolidate  free  space.)  The  principal  disadvan- 
tage of  this  suggestion  is  that  the  EXIT  command  causes  the  keypad 
editor  to  close  all  open  files,  discard  the  contents  of  the  paste,  line,  word, 
and  character  buffers,  and  restore  any  special  settings  you  made  to  it's 
default  values. 

2.  Erase  and  Make  Room  for  Insertions 

When  the  output  file  is  full  and  valuable  material  is  in  the  pa.ste  buffer  or 
other  buffers,  you  can  make  room  for  the  valuable  material  by  erasing  part 
of  your  file.  Each  character  you  erase  makes  room  for  one  additional 
character  during  the  current  session. 
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3.    Use  an  Auxiliary  Output  P'ile 

When  the  output  file  is  full,  you  can  split  it  into  two  files.  Use  the  OPEN 
OUTPUT  command  to  open  an  auxiliary  output  file  and  the  WRITE  com- 
mand to  store  as  much  of  the  output  file  as  necessary.  When  the  keypad 
editor  completes  the  WRITE  command,  use  the  CLOSE  command  to  save 
the  auxiliary  output  file  and  then  erase  the  section  of  the  output  file  that 
you  stored  elsewhere. 

In  most  cases,  you  can  recombine  the  parts  of  the  original  file  in  another 
keypad  editor  session.  If  free  space  is  still  not  sufficient,  use  a  new  output 
volume. 

A. 6    When  a  Function  Seems  to  Insert  Strange  Characters 

One  hardware  feature  of  your  terminal  is  called  the  character  silo.  The  silo 
holds  characters  that  you  type  while  waiting  for  your  system  to  pass  them  to 
the  keypad  editor.  When  you  use  the  VTlOO  autorepeat  feature  or  the  VT52 
Repeat  key  to  repeat  a  single-key  function,  you  may  overfill  the  terminal  silo. 
When  that  occurs,  the  terminal  signals  you  with  the  terminal  bell  (and  no 
keypad  editor  message  is  available  because  the  keypad  editor  has  not  caused 
the  signal). 

In  this  case,  characters  that  you  have  i.  it  typed  may  appear  on  your  screen. 
The  question  mark  O  and  lowercase  or  uppercase  letters  are  the  most  com- 
monly reported  insertions.  The  reason  the  characters  are  inserted  is  that  the 
overfilled  silo  has  disrupted  the  stream  of  characters  being  sent  to  the  keypad 
editor,  and  the  keypad  editor  interprets  some  of  the  incoming  characters  as 
insertions,  not  as  editing  functions. 

To  avoid  this  problem,  avoid  unusually  long  bursts  of  automatic  repeating.  To 
correct  the  problem,  you  can  either  erase  the  unwanted  characters  by  using 
the  keypad  functi(ms  for  erasing  or  you  can  stop  editing  without  creating  an 
output  file  by  using  the  QUIT  command. 
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ADJUST  illegal  in  inspect  mode 

The  TABS  AD.Jl  ST  command  is  in-      Use  another  command  or  function, 
valid  when  you  are  in.spectinfj  a  file. 

Advance  char  find§  end  of  file 

The  CH.AR  function  or  the  ri^htarrow      Use  any  valid  function  or  command, 
function  moved  the  cursor  to  the  bot- 
tom of  the  file. 

Advance  line  finds  end  of  file 

The  BLINK  function  has  moved  the      I'se  another  function. 

cursor  to  the  end  of  the  file.  With  line 

count  definitions,  the  PACiE  and  SKC- 

TION   functions   can  also  cau.se  this 

message. 
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Advance  word  finds  end  of  file 

The  WORD  function  moved  the  cursor 
to  the  bottom  of  the  file  or  the  DEL- 
WORD  function  erased  the  last  char- 
acter in  the  file. 

Argument  error  to  INCLUDE  or  SKIP 

The  keypad  editor  did  not  complete  an 
INCLUDE  or  SKIP  command  because 
you  specified  a  negative  line  or  page 
count. 

Argument  error  to  WRITE 

The  keypad  editor  did  not  complete  a 
WRITE  command  because  you  speci- 
fied a  negative  line  or  page  count. 

Arrow  command  finds  extremity  of  file 

The  uparrow  function  moved  the  cur- 
sor to  the  top  of  the  file,  or  the 
downarrow  function  moved  the  cursor 
to  the  bottom  of  the  file. 


Use  any  valid  function  or  command. 


Use  any  valid  function  or  command. 


Use  anv  valid  function  or  command. 


Use  any  valid  function  or  command. 


Auxiliary  input  file  contains  records  that  will  be  truncated 

The  keypad  editor  loads  this  message      Use  any  valid  function  or  command, 
for  your  information  when  you  answer 
"no"  to  the  following  message. 

Auxiliary  input  file  contains  records  that  will  be  truncated  —  Continue  (Y.N)? 


The  largest  record  in  the  auxiliary  in- 
put file  that  you  have  specified  is 
larger  than  the  keypad  editor  can  read 
entirely. 


Auxiliary  input  file  not  open 

The  keypad  editor  did  not  complete  an 
I NCLUDE  command  because  no  auxi- 
liary input  file  is  open.  The  keypad  ed- 
itor automatically  closes  an  auxiliary 
input  file  when  an  I  NCLUDE  or  SK  I  P 
command  has  processed  the  entire  file. 

Auxiliary  input  illegal  during  inspect 

When  you  are  inspecting  a  file,  the 
keypad  editor  cannot  complete  func- 
tions and  commands  that  would  mod- 
ify the  file. 

Auxiliary  output  file  exists 

The  keypad  editor  loads  this  message 
for  your  information  when  you  answer 
"no"  to  the  following  message. 

Auxiliary  output  file  exists  —  Replace  (Y.N)  ? 
The  auxiliary  output  file  name  you 
specified  is  the  same  as  an  existing  file 
on  the  output  volume. 


To  have  the  keypad  editor  continue,  type 
Y  and  press  the  Return  key.  The  overlong 
record  will  be  truncated  when  the  keypad 
editor  reads  it,  and  the  truncated  data 
will  be  lost.  To  stop  the  keypad  editor, 
type  N  and  press  the  Return  key. 

To  open  an  auxiliary  input  file,  use  the 
OPEN  INPUT  command.  Otherwise,  use 
any  valid  function  or  command. 


Use  any  valid  function  or  command. 


Use  any  valid  function  or  command. 


To  erase  the  existing  file  and  create  a  new 
one  with  the  same  name,  type  Y  and 
press  the  Return  key.  To  preserve  the  ex- 
isting file,  type  any  other  answer. 
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Auxiliary  output  fiie  full 

No  more  space  remains  in  the  auxili- 
ary output  file. 


Auxiliary  output  file  not  open 

The  keypad  editor  did  not  complete  a 
WRITE  command  because  no  auxili- 
ary output  file  is  open.  The  CLOSE 
and  EXIT  commands  close  an  auxili- 
ary output  file.  The  PURGE  and  QUIT 
commands  discard  an  auxiliary  output 
file,  if  one  is  open. 

Backup  char  findi  beginning  of  file 

The  CHAR  function  or  leftarrow  func- 
tion moved  the  cursor  to  the  top  of  the 
file. 

Backup  line  finds  beginning  of  file 

The  BLINE  function  has  moved  the 
cursor  to  the  top  of  the  file.  With  line 
count  definitions,  the  PAGE  and  SEC- 
TION functions  can  also  cause  this 
message. 

Backup  word  finds  beginning  of  file 

The  WORD  function  or  LINEFEED 
function  moved  the  cursor  to  the  top  of 
the  file. 

Bounded  search  reached  bound 

You  have  used  the  SET  SEARCH 
BOUNDED  command  to  limit  searches 
to  one  page.  Then  a  FIND  or  FIND- 
NEXT  function  moved  the  cursor  to 
the  top  or  bottom  of  a  page  without 
finding  a  string  that  matches  the 
model  you  have  specified. 

CHNGCASE  rinds  end  of  file 

In  the  ADVANCE  directional  mode, 
the  CHNGCASE  function  changed  the 
case  of  the  last  character  in  the  file. 

CHNGCASE  is  illegal  during  inspect 

When  you  are  inspecting  a  file,  the 
keypad  editor  cannot  complete  func- 
tions and  commands  that  would  mod- 
ify the  file. 
Command  canceled 

The  keypad  editor  loads  this  message 
when  you  type  Cmg)  or  ^mjQ  to  can- 
cel a  keypad  editor  command  and  the 
Command  :  prompt. 


Command: 


The  keypad  editor  displays  this 
prompt  after  you  use  the  COMMAND 
function. 


Use  the  CLOSE  command  to  close  the 
auxiliary  output  file.  Open  another  file 
for  auxiliary  output  and  merge  the  files 
later  in  a  separate  editing  session.  Or,  use 
the  RT-11  COPY  command,  the  PIP  util- 
ity, or  the  IAS  PDS  APPEND  command 
to  merge  the  files. 

To  open  an  auxiliary  output  file,  use  the 
OPEN  OUTPUT  command.  Otherwise, 
use  any  valid  function  or  command. 


Use  any  valid  function  or  command. 


Use  another  function. 


Use  any  valid  function  or  command. 


Use  any  valid  function  or  command. 


Use  another  function  or  command. 


Use  any  valid  function  or  command. 


Use  any  valid  function  or  command. 


Type  the  command  you  want  the  keypad 
editor  to  execute  and  terminate  the  com- 
mand with  the  ENTER  function. 
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CTRL/C  entered  to  stop  operation 

The  keypad  editor  loads  this  message 
when  you  type  &RLC  frSTC  to  cancel 
the  command  or  function  that  the  key- 
pad editor  is  processing.  The  keypad 
editor  repaints  your  terminal  screen 
and  shows  where  the  cursor  moved.  If 
you  typed  commands  or  functions 
wnile  the  keypad  editor  was  displaying 
the  WORKING.  .  .  message,  the  key- 
pad editor  ignores  all  of  them. 

CTRL/C  or  CTRL/Z  ignored  -  use  QUIT 

While  you  are  working  with  a  file,  the 
keypad  editor  ignore?  the  Elk?  and 
tn'RiC   combinations. 


CTRL/U  finds  beginning  of  file 

The  CTRL/l"  function  erased  the  first 
character  in  the  file. 

Cursor  not  at  target 

With  no  existing  select  range,  the  key- 
pad editor  could  not  complete  a  Cl'T. 
APPEND.  PA.STP:.  or  SlBSTinTE 
function  becau.se  the  cursor  is  not  at  a 
valid  search  target. 


I'se  anv  valid  function  or  command. 


To  insert  ®Z;  <>r  fl?LC  in  your  file,  use 
the  SPECINS  function.  To  cancel  a  key- 
pad editor  session  without  saving  any 
open  output  files,  use  the  QUIT  com- 
mand. 

Tse  anv  valid  function  or  command. 


I'se  anv  valid  function  or  command. 


DELCHAR  finds  end  of  file 

The  DELCHAR  fun  ion  erased  the 
last  character  in  the  .  le. 

DELEOL  finds  end  of  file 

The  DF'LF^OL  function  erased  the  last 
character  in  the  file. 

DELETE  finds  beginning  of  file 

The  DELETE  function  era.-^ed  the  first 
character  in  the  file. 

DELLINE  finds  end  of  file 

The  DEI.LINF'.  function  erased  the 
last  character  in  the  file. 

Empty  select  range  specified  to  CHNfJCASE 

.After  using  the  SELECT  function,  you 
used  the  CH.NdCASE  function  before 
building  a  select  range 

End  of  file  reached  on  auxiliary  input  file 

A  SKIP  or  an  INCLUDE  command 
finished  reading  to  the  bottom  of  an 
auxiliary  input  file  and  (he  keypad  ed- 
itor automatically  closed  the  file. 

EOL  finds  beginning  of  file 

The  EOL  function  moved  the  cursor  to 
the  (op  of  the  file. 

EOL  finds  end  of  file 

The  EOL  function  moved  the  cursor  to 
the  bottom  of  the  file 


I'se  iui\  valid  functicm  or  command. 


I'se  any  valid  function  or  command. 


I'se  anv  valid  function  or  command. 


I'se  anv  valid  function  or  command. 


To  change  the  case  of  several  letters, 
build  a  select  range  that  includes  them 
and  then  u.se  the  CHN(JCASE  function. 

I'se  any  valid  function  or  command. 


I'se  any  valid  function  or  ctmimand. 


I'se  anv  valid  function  or  command. 
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Erasures  are  illegal  during  inspect 

When  you  are  inspecting  a  file,  the 
keypad  editor  cannot  complete  func- 
tions and  commands  that  would 
modify  the  file. 

Error  reading  auxiliary  input  file 

The  keypad  editor  could  not  read  the 
auxiliar>-  input  device  The  problem  is 
not  due  to  reaching  the  end  of  the  file. 

Error  writing  auxiliary  output  file 

The  keypad  editor  may  have  detected 
a  bad  block  or  faultv  device. 


I'se  anv  valid  function  or  command. 


EXIT  stopped  by  CTRL/C 

The  keypad  editor  loads  this  message 
when  you  type  gSTC  to  cancel  the 
EXIT  command.  The  results  are  un- 
predictable because  they  depend  on 
several  variable  factors,  such  as  the 
output  file  size,  the  speed  of  the  hard- 
ware components  you  are  using,  and 
when  you  type  @rc;  during  the  EK  I  T 
process. 


File  full  during  FILL 

The  keypad  editor  could  not  complete 
the  FILL  command  or  function  be- 
cause the  output  file  or  temporary  file 
is  full. 

File  full  during  INCLUDE 

The  keypad  editor  could  not  complete 
the  INCLUDE  command  because  the 
output  file  is  not  large  enough  for  the 
material  you  want  to  copy.  The  cursor 
is  to  the  right  of  tht  last  character  the 
keypad  editor  copied  from  the  auxi- 
liary input  file. 

FILL  illegal  during  inspect 

I  he  FILL  command  or  function  is  in- 
valid while  you  are  inspecting  a  file. 

I/O  error  closing  auxiliary  output  file 

The  keypad  editor  could  not  write  to 
the  auxiliarv  output  file  during  a  close 
operation.  The  keypad  editor  may 
have  detected  a  bad  block. 


If  the  file  name  was  correct,  check  tha* 
the  device  is  on-line  and  that  it  contains 
the  proper  volume.  Use  another  device  if 
the  device  is  faulty. 

('heck  that  the  device  is  on-line,  write- 
enabled,  and  properly  formatted.  Try 
using  another  auxiliary  output  device  or 
volume.  I'se  the  RT-11 

OIRECTQRY/BADBLQCKS  command  to 
check  for  bad  blocks. 

If  you  type  pRkS  t^wic;  too  late  to  cancel 
the  EXIT  process,  the  keypad  editor  dis- 
plays the  command  level  prompt  again. 
In  this  case,  the  output  files  you  origi- 
nally specified  have  been  saved.  If  you 
al.so  specified  automatic  backup  of  input 
files,  they  have  also  been  renamed.  If 
GBkC]  CTRiq  cancels  the  EXIT  process, 
the  keypad  editor  repaints  the  terminal 
screen  with  the  part  of  the  file  that  con- 
tains the  cursor.  In  this  case,  continue 
editing  by  using  any  valid  function  or 
command. 

Refer  to  Section  A. 5. 


Refer  to  Section  A. 5  of  this  appendix  for 
suggestions  that  may  be  useful  when  your 
file  is  full.  You  can  also  use  the  CLOSE  or 
QUIT  commands  or  any  functions  or 
commands  that  erase  material  from  the 
file. 


Use  another  function  or  command. 


Try     using     another     auxiliary     output 
volume.  I  se  the  RT    11 

DiryECTOryY/BADBLOCKS  command  to 
check  for  bad  blocks. 
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Illegal  command 

The  keypad  editor  could  not  recognize 
the  command  you  typed. 

Illegal  definition  of  PAGE  or  SECTION 

The  keypad  editor  could  not  process  a 
SET  '■NTITY  PAGE  or  SET  ENTITY 
SECTION  command  for  one  of  the  fol- 
lowing reasons: 

•  the  string  marker  was  not  enclosed 
in  matching  single  quotes  or  double 
quotes. 

•  the  string  marker  was  enclosed  in 
illegal  delimiters. 

•  in  a  line  count  definition,  you  did 
not  specify  a  value  greater  than  zero. 


Illegal  file  specification 

The  file  specification  you  t'ped  in  an 
OPEN  INPUT  or  OPEN  OUTPUT  com- 
mand was  not  a  valid  file  specifica- 
tion. 


l'.<<e  anv  valid  function  or  command. 


Use  any  valid  function  or  command. 


Use  any  valid  function  or  command. 


Illegal  function 

The  keypad  editor  could  not  recognize 
the  function  you  specified  and  also 
could  not  directly  insert  the  characters 
you  typed.  The  most  common  cause  is 
typing  the  Escape  key  and  then  almost 
any  other  key  on  the  keyboard  or  the 
keypad. 


To  insert  an  Escape  character  or  another 
character  that  you  cannot  insert  directly, 
use  the  SPECINS  function.  You  can  also 
use  anv  valid  function  or  command. 


Illegal  right  column  for  wrap 

You  specified  a  right  margin  that  is 
greater  than  256  in  the  SET  WRAP 
command. 

Illegal  tab  indent  value 

You  specified  an  indentation  value  of  0 
or  less  in  the  SET  TABS  command. 


Enter  the  command  again,  or  use  another 
function  or  command. 


Enter  the  command  again,  or  use  another 
function  or  command. 


Illegal  terminating  key 

The  keypad  editor  could  not  complete 
a  FIND  function  for  one  of  the  fol- 
lowing reasons: 

•  you  included  an  illegal  character  in 
the  model. 

•  you  did  not  terminate  the  model 
with  the  ADVANCE  or  BACKUP 
function. 


Use  any  valid  function  or  command. 
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Illegal  terminating  key  to  command  prompt 

The  keypad  editor  could  not  process  a 
command  for  one  of  the  following  rea- 
sons: 

•  you  included  an  illegal  character  in 
the  command. 

•  you  did  not  terminate  the  command 
with  the  ENTER  function. 

Illegal  to  insert  null 

With  the  SPECINS  function,  you 
specified  the  NULL  character  (ASCII 
code  0).  The  keypad  editor  does  not 
allow  you  to  insert  nulls  in  any  file. 

INCLUDE  and  SKIP  illegal  during  inspect 

When  you  are  inspecting  a  file,  the 
keypad  editor  cannot  complete  func- 
tions and  commands  that  would 
modify  the  file. 

INCLUDE  finds  end  of  auxiliary  input  file 

Your  last  INCLUDE  command  copied 
the  last  character  of  the  auxiliary 
input  file  to  your  main  file.  The 
keypad  editor  closed  the  auxiliary 
input  file. 

Insert  finds  file  full 

The  keypad  editor  could  not  insert  the 
character  you  typed  because  the 
output  file  is  not  large  enough. 


Insert  failure  in  local 

You  stopped  the  processing  of  a 
LOCAL  command  by  typing  CTRL/C 
or  the  keypad  editor  could  not  finish 
processing  for  some  other  reason. 

Insert  is  illegal  during  inspect 

When  you  are  inspecting  a  file,  the 
keypad  editor  cannot  complete  func- 
tions and  commands  that  wo;ild 
modify  the  file. 

Invalid  parameter  to  ADJUST 

In  the  TABS  ADJUST  command,  you 
specified  an  adjustment  that  is  outside 
the  range  of    fiO  to  +50. 

Invalid  parameter  to  LOCAL 

In  the  LOCAL  command,  you  speci- 
fied a  starting  value  or  increment  that 
is  0  or  greater  than  .'?27(i7. 

?KED-F-Bad  call  to  .VVV.V 


Use  any  valid  function  or  command. 


Use  another  command  or  function. 


Use  any  valid  function  or  command. 


Use  another  function  or  command. 


Refer  to  Section  A. 5  of  this  appendix  for 
suggestions  that  may  be  useful  when  your 
file  is  full.  You  can  also  use  the  CLOSE  or 
QUIT  command  or  any  funttions  or  com- 
mands that  erase  material  from  the  file. 


Use  any  valid  function  or  command. 


Enter  the  command  again,  or  use  another 
command  or  function. 


Flnter  the  command  again,  or  use  another 
command  or  function. 


The  keypad  editor  may  have  malfunc- 
tioned. 


Refer  to  the  procedure  in  Section  A. 4  of 
this  appendix. 
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?KED-F-Directory  file  does  not  exist 

On  an  RSX-U  system,  ♦he  keypad  ed- 
itor cannot  access  the  directory  file  for 
one  of  the  UICs  in  the  file  sjjecification 
string. 

?KED-F-Illegal  command  line 

?KED-F-Illegal  file  specification 

The  keypad  editor  may  have  malf'nc- 
tioned. 

?KED-F-Insufficient  memory 

The  keypad  editor  may  have  malfunc- 
tioned or  cannot  run  because  too  little 
memory  is  available.  (The  keypad  ed- 
itor requires  approximately  16K 
words.) 


Check  for  a  typing  error.  Reenter  the  file 
specification  string. 


Refer  to  the  procedure  in  Section  A.4  of 
this  appendix. 


RT-11: 

Switch  to  a  system  that  provides  more 
memory  resources  or  switch  to  a  smaller 
RT-11  monitor.  In  the  RT-11  System 
Message  Manual,  the  section  entitled  In- 
creasing Storage  and  Memory  Resources 
offers  other  suggestions  that  may  be 
useful.  If  the  message  continues  to  ap- 
pear, refer  to  the  procedure  in  Section  A.4 
of  this  appendix. 

RSX-11  and  IAS:  | 

Ensure  that  the  keypad  editor  has  been 
properly  built  and  installed,  and  that 
there  is  a  large  enough  task  size  incre- 
ment. 


7KED-F-I/0  or  device  error  —  Continue  (Y,N) 
The  keypad  editor  detected  an  I/O  or 
device  error.  Examples  of  situations 
that  can  cause  this  message  are: 

•  a   device  you  are  using  has  been 
switched  off-line. 

•  an  output  device  you  are  using  has 
been  write- locked. 

•  a  volume  you  are  using  hs^g  a  bad 
block. 


Before  typing  any  response,  check  that 
the  device  is  on-line,  and  if  it  is  an  output 
device,  check  that  it  is  write-enabled.  To 
make  the  keypad  editor  try  the  same 
function  or  command  once  more,  type  Y 
and  press  the  Return  key.  The  keypad  ed- 
itor then  tries  the  function  or  command 
once  more.  If  the  command  or  function 
works,  continue  editing.  If  the  command 
or  function  does  not  work,  or  if  you  type 
any  character  other  than  Y,  the  keypad 
editor  quits  without  saving  any  of  your 
editing  work  and  returns  to  the  RT-11 
monitor. 


7KED-F-I/0  error  while  trimming  output 

The  keypad  editor  may  have  malfunc- 
tioned. 

?KED-F-Output  file  shorter  than  input  file 

The  space  available  for  the  output  file 
is  smaller  than  the  input  file. 


Refer  to  the  procedure  in  Section  A.4  of 
this  appendix. 


RT-11: 

Use  the  RT-11  SQUEEZE  command  to 
consolidate  free  space  on  the  output 
volume  or  use  a  different  volume. 

RSX-11  and  IAS: 

Specify  the  output  filesize  correctly  or  use 
the  default.  There  may  not  be  sufficient 
storage  space  on  the  volume. 
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7KED-F-RDBKW  -  No  space  to  read  into 
7KED-F-RDFWD  -  No  space  to  read 
?KED-F-RDFWD  -  Pointer  corrupt 
7KED-F-SETUP  -  AUocation  error 
7KED-F-SPCFRE  —  Logic  error,  character  count  wrong 

The  keypad  editor  may  have  malfunc-      Refer  to  the  procedure  in  Section  A.4  of 

tio"ed.  this  appendix. 


?KED-F-Temporary  file  shorter  than  input  file 

The  number  of  blocks  that  you  speci- 
fied with  the  /BL  option  is  less  than 
the  size  of  the  input  file  that  you  spec- 
ified. 

7KED-F-TTY???  Logic  error 

The  keypad  editor  may  have  malfunc- 
tioned. 

?KED-F-Unable  to  access  input  device 

The  keypad  editor  could  not  access  the 
auxiliary  device  for  one  of  the  fol- 
lowing reasons: 

•  the  device  is  illegal. 

•  the  device  is  not  ready. 

•  the  device  is  not  installed. 

•  the    volume    has    too    many    bad 
blocks. 

•  no  room  for  the  device  handler. 


Enter  the  command  line  again  with  a 
temporary  file  size  that  is  greater  than 
the  input  file  size. 
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?KED-F-Unable  to  access  output  device 

The  keypad  editor  probably  could  not 
load  the  output  device  handler. 


?KED-F-Unable  to  attach  terminal 

The  keypad  editor  cannot  attach  your 
terminal  and  therefore  cannot  pro- 
ceed. 

?KED-F-Unable  to  copy  temporary  file 

With  an  RSX  system  and  after  you 
have  used  the  EXIT  command,  the 
system  cannot  properly  convert  the 
keypad  editor's  temporary  file. 
(Chapter  2  explains  temporary  file 
usage.)  The  system  locks  both  the 
temporary  file  and  the  output  file. 


Refer  to  the  procedure  in  Section  A.4  of 
this  appendix. 

RT-11: 

Check  the  device  abbreviation.  If  it  is  cor- 
rect, check  that  the  device  is  on-line.  Use 
the  RT-11  SHOW/DEi.'ICES  command 
to  see  which  devices  your  system  in- 
cludes, and  use  the  RT-11  INSTALL 
command  to  install  the  device  you  need, 
if  necessary.  If  the  message  continues  to 
appear,  use  the  RT-11 

DirvECTORY/BADBLOCKS  command  to 
check  the  volume  you  are  using  for  bad 
blocks,  and  if  there  are  many  bad  blocks 
on  the  volume,  use  another  copy.  If  you 
cannot  install  the  handler  for  the  device 
you  want  to  use,  try  the  suggestions  listed 
in  the  documentation  for  the  message 
"?KED-F-Insufficient  memory." 

RSX-11  and  IAS: 

Correctly  specify  the  input  device. 

If  the  device  name  was  correct,  check 
that  the  system  volume  contains  the  de- 
vice handler.  If  the  message  continues  to 
appear,  try  the  suggestions  for 
"?KED-F-Unable  to  access  input  de- 
vice." 

Check  with  your  system  manager. 


If  you  must  try  to  salvage  either  the 
locked  temporary  file  or  the  output  file, 
use  the  PIP  UNLOCK  command  which  is 
described  in  the  RSX-II  i'tilities  Man- 
ual or  the  IAS  Utilities  Manual.  Or.  use 
the  PDS  commands  I'NLOCK  and  SET 
END-OF-FILE.  described  in  the  IAS 
PDS  User's  Guide. 
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?KED-F-Unable  to  create  output  file 

?KED-F-Unable  to  create  temporary  file 

v'»  ith  RSX  or  IAS  systems,  the  keypad 
editor  cannot  create  the  specified  file 
on  the  output  volume  and  in  the  direc- 
tory that  you  have  specified.  Three 
causes  for  this  message  are: 

•  A  protection  violation. 

•  Too    little    space    on    the    output 
volume. 

•  An  I/O  erroi. 


Check  that  the  output  device  is  online 
and  write-enabled.  Check  that  your 
output  volume  contains  sufficient  free 
space  as  described  in  Chapter  2.  Check 
that  the  current  UIC  has  the  correct  file 
protection  attributes. 


?KED~F-Unable  to  edit  input  file 

The  input  file  that  you  specified  is  too 
long  to  be  handled  by  the  keypad  ed- 
itor. With  the  keypad  editor,  you 
cannot  edit  a  file  that  is  larger  than 
16383,  blocks. 


Find  some  other  way  to  edit  the  file.  If 
necessary,  consult  an  experienced  col- 
league about  the  problem  of  splitting  the 
file  into  separate  parts  that  are  small 
enough  for  the  keypad  editor. 


?KED-F-Unable  to  open  input  fiie 

The  keypad  editor  could  not  open  the  Check  the  file  specification.  If  it  is  cor- 

input  file  for  one  of  the  following  rea-  rect,  check  that  the  correct  volume  has 

*'""s:  been  installed  and  that  the  input  device 

is  on-line. 

•  the  volume  does  not  contain  the  file. 

•  the  volume  has  not  been  initialized. 

•  the  input  device  is  not  on-line. 


?KED-F-Ui.  Uie  to  open  output  fiie 

The  keypad  editor  could  not  open  the 
output  file  for  one  of  the  following  rea- 
sons; 

•  the  device  is  not  ready  or  is  write- 
iocked. 

•  the  volume  has  not  been  initialized. 

•  the  volume  does  not  have  sufficient 
fr'^e  space  for  the  oi^tput  file. 

•  the  output  file  exists  and  has  been 
protected. 


Check  that  the  output  volume  is  properly 
installed  and  that  it  has  been  initialized. 
If  the  volume  is  too  full,  use  another 
volume.  To  edit  a  protected  file,  use  a 
different  output  file  specification. 


^ 


?KED-F"Unable  to  trim  output  file 
7KED-F-WRBKW  --  Bad  block  number 
7KED-F-WRBKW    -  Block  overrun 
?KED-F-WRBK'A  -  Plygnd  not  empty 
7KED-F-WRFWD  -  Bad  block  number 
7KED-F-WRFWD  -  BJock  overrun 
?KED-F-WRFWD  -  Not  enough  data 

The  keypad  editor  may  have  malfunc- 
tioned. 


Refer  to  the  procedure  in  Section  A. 4  of 
this  appendix. 
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?KED-W-Input  file  contains  records  that  will  be  truncated  —  Continue  (Y.N)? 


The  largest  variable  length  record  in 
the  input  file  is  larger  than  the  space 
that  the  keypad  editor  has  available  to 
read  records.  Records  larger  than  that 
space  will  be  truncated  when  read, 
and  the  truncated  data  will  be  lost. 


To  have  the  keypad  editor  continue  pro- 
gressing, type  Y  and  press  the  Return  key. 
To  stop  the  keypad  editor,  type  N  and 
press  the  Return  key. 


?K£D-W-Input  file  not  properly  closed  —  Continue  (Y.N)? 


The  keypad  editor  finds  conflicting  in- 
formation about  the  input  file  that  you 
specified. 


To  have  the  keypad  editor  continue,  type 
Y  and  press  the  Return  key.  The  kejrpad 
editor  will  try  to  read  the  file,  but  the  file 
may  contain  invalid  data  that  you  may 
have  to  delete.  If  data  at  the  end  of  the 
file  appears  to  have  been  deleted  because 
the  end  of  file  symbol  appears  earlier 
than  you  expected,  the  file  may  contain  a 
record  that  is  too  long  for  one  of  the 
keypad  editor's  buffers. 

To  stop  the  keypad  editor,  type  N  and 
press  the  Return  key. 


?KED-W-Only  XXXXXX  blocks  available  for  insertions  —  Continue  (Y.N)? 


Free  space  on  the  output  volume  is 
less  than  10  blocks  larger  than  the 
input  file.  The  keypad  editor  reports 
(in  decimal)  the  number  of  blocks 
available. 


To  continue  the  editing  session,  type  Y 
and  press  the  Return  key.  The  keypad  ed- 
itor will  signal  when  the  file  becomes  as 
large  as  possible.  To  cancel  the  editing 
session  and  return  to  the  RT-U  com- 
mand level  prompt  (*),  type  any  other 
answer.  Use  the  RT-U  SQUEEZE  com- 
mand to  consolidate  free  space  on  the 
output  volume,  or  specify  an  output 
volume  that  has  more  free  space. 


?KED-W-Output  file  exists  -  Continue  (Y.N)  ? 
The  output  file  name  you  specified  is 
the  same  as  an  existing  file  on  the 
output  volume. 


To  erase  the  existing  file  and  create  a  new 
one  with  the  same  name,  type  Y  and 
press  the  Return  key.  To  preserve  the  ex- 
isting file  and  return  to  the  system  or 
keypad  editor  prompt,  type  any  other  an- 
swer. 


?KED-W-Output  files  purged 

The  keypad  editor  displays  this  mes- 
sage when  you  use  the  QUIT  com- 
mand. If  an  auxiliary  output  file  is 
open  when  you  type  the  command,  the 
keypad  editor  does  not  save  the  file.  If 
you  are  editing  or  creating  a  file,  the 
keypad  editor  does  not  save  any  of 
your  editing  work. 


The  message  is  for  information  only. 


?KED-W-Unable  to  rename  input  file  to  BAK  file  type 


The  original  input  file  was  not  saved 
with  the  BAK  file  type.  However,  the 
keypad  editor  attempted  to  save  the 
output  file. 


The  mesi^age  is  primarily  for  your  infor- 
mation. If  you  do  not  have  another  copy 
of  the  original  file,  there  is  no  way  you 
can  recover  it. 
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?KED-W-Unabie  to  truncate  or  close  output  file 

With  an  RSX  system  and  after  you 
have  used  the  EXIT  command,  the 
system  cannot  properly  store  your 
output  file.  The  system  locks  the 
output  file  because  the  file  may  be 
faulty. 

Learn  buffer  filled 

The  functions  and  commands  that  you 
have  used  since  you  entered  the 
LEARN  command  require  too  many 
bytes  for  the  learn  buffer.  The  keypad 
editor  immediately  stops  storing  the 
macro  and  erases  the  contents  of  the 
learn  buffer. 


LOCAL  illegal  during  inspect 

You  entered  the  LOCAL  command 
while  inspecting  a  file. 

Local  symbol  definition  too  long 

In  processing  a  LOCAL  command,  the 
keypad  editor  detected  a  local  symbol 
that  is  more  than  6  digits  long. 

Logic  error  in  ADJUST 

Logic  error  in  CHNGCASE 

Logic  error  in  CUT 

Logic  error  in  FILL 

Logic  error  in  PASTE 

Logic  error  in  SUBSTITUTE 

Logic  error  in  undelete 

Logic  error  in  undelete  setup 

Logic  error  in  WRITE  SELECT 

The  keypad  editor  may  have  malfunc- 
tioned. 


Model: 


The  keypad  editor  displays  this 
prompt  after  you  use  the  F  IND  func- 
tion. 


Move  failure  in  'v><*al 

You  '.stopped  the  processing  of  a 
LOCAL  commard  by  pressing 
CTRL/C.  or  the  keypad  editor  coula 
not  finish  pajcessinp  ''  ommand  for 
some  other  reason. 


It  you  must  try  to  .salvage  the  locked 
output  tile,  use  the  PIP  I'NLOCK  com- 
mand. The  command  is  described  in  the 
RSX  1 1  I  'tilitirs  Manual  or  the  IAS  I  'til- 
itii's  Mnmuil. 


Check  that  you  are  not  using  unnecessary 
ADVANCE  or  BACKUP  functions  in 
your  macro.  Use  abbreviations  for  com- 
mands within  the  macro,  and  use  the 
shortest  possible  search  models  within 
the  model.  Table  5-1  shows  the  minimum 
number  of  bytes  each  function  and  com- 
mand requires. 

Use  another  command  or  function. 


Check  that  the  local  symbol  is  correct. 


Refer  to  the  procedure  in  Section  A. 4  of 
this  appendix. 


Type  the  string  you  want  the  keypad  ed- 
itor to  search  for  and  then  specify  the  di- 
rection of  search  with  the  ADVANCE  o; 
BACKUP  function.  You  can  specify 
models  from  1  to  46  characters  long. 


Move  PAGE  or  SECTION  finds  extremity  of  file 

A  PAfJE  or  SECTION  function  moved      Use  any  valid  function  or  command. 

the  cursor  to  the  fop  or  bottom  of  the 

file. 


Move  to  bottom  when  at  bottom 

The  BOTTOM  function  is  not  valid 
when  the  cursor  is  already  at  the 
bottom  of  the  file. 


Use  any  valid  function  or  command. 
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Move  to  top  virhen  at  top 

The  TOP  function  is  not  valid  when 
the  cursor  is  already  at  the  top  of  the 
file. 

No  macro  to  execute 

The  macro  buffer  is  empty  either  be- 
cause you  have  not  used  the  T.SARN 
command  to  store  a  macro  or  because 
the  last  macro  that  you  tried  to  store 
failed  while  you  were  defining  it. 

No  model  defined 

The  keypad  editor  could  not  process 
the  FINDNEXT,  REPLACE,  or  SUB- 
STITUTE function  because  you  have 
not  yet  specified  a  search  model. 


No  select  range  defined 

You  attempted  a  REPLACE,  AP- 
PEND, or  CUT  function  without  pre- 
viously defining  a  select  range  and  the 
cursor  was  not  located  at  a  search 
target. 

No  select  range  define  for  FILL 

There  were  no  characters  in  a  select 
range  or  you  were  not  building  a  select 
range  when  you  used  the  FILL  func- 
tion or  command. 

No  select  range  for  ADJUST 

You  are  not  building  a  select  range  or 
there  are  no  characters  in  the  select 
range  that  you  are  building. 

No  select  range  for  WRITE  SELECT 

You  have  used  the  SELECT  function 
and  then  entered  the  WRITE  SE- 
LECT command.  However,  there  are 
no  characters  in  the  select  range  that 
you  are  building. 

Not  enough  file  space  to  do  PASTE 

The  keypad  editor  could  not  complete 
the  PASTE  function  because  the 
output  file  is  not  large  enough  for  the 
material  that  is  in  the  paste  buffer. 
The  cursor  is  located  to  the  right  of  the 
last  character  the  keypad  editor 
copied  from  the  paste  buffer. 


Use  any  valid  function  or  command. 


Use  the  LEARN  command  to  store  the 
macro  that  you  want  to  use. 


To  search  for  a  string,  use  the  FIND  func- 
tion, type  a  model  of  the  string  you  want 
the  keypad  editor  to  search  for,  and  then 
specify  the  direction  of  search  with  the 
ADVANCE  or  the  BACKUP  function. 
You  can  also  use  any  other  valid  function 
or  command. 

Use  any  valid  function  or  command. 


Build  a  select  range  that  contains  the  seg- 
ment of  your  file  that  you  want  to  refor- 
mat before  using  the  FILL  command  or 
function. 

Build  a  select  range  that  includes  the  seg- 
ment of  your  file  that  you  want  to  adjust 
before  using  the  TABS  ADJUST  com- 
mand. 

Build  a  select  range  that  includes  the  ma- 
terial that  you  want  to  copy  to  the  auxi- 
liary output  file,  and  then  enter  the 
WRITE  SELECT  command. 


Refer  to  Section  A. 5  of  this  appendix  for 
suggestions  that  may  be  useful  when  your 
file  is  full.  You  can  also  use  the  EXIT  or 
QUIT  command  or  any  functions  or  com- 
mands that  erase  material  from  the  file. 
If  you  use  the  EX  I  T  or  OU I  T  command, 
the  keypad  editor  preserves  the  material 
in  the  paste  buffer  for  your  next  session 
until  you  stop  the  keypad  editor  com- 
pletely and  return  to  the  system  level. 
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Not  enough  space  to  undelete 

The  keypad  editor  could  not  complete 
an  UNDELLINE.  UNDELWORD,  or 
UNDELCHAR  function  because  the 
output  file  is  not  large  enough  for  the 
added  material.  The  cursor  is  located 
to  the  right  of  the  last  character  the 
keypad  editor  copied. 


Refer  to  Section  A. 5  of  this  appendix  for 
suggestions  that  may  be  useful  when  your 
file  is  full. 


Nothing  to  undelete 

The  keypad  editor  could  not  process 
an  UNDELLINE,  UNDELWORD,  or 
UNDELCHAR  function  because  the 
corresponding  line,  word,  or  character 
buffer  is  empty. 


Use  unv  valid  function  or  command. 


OPENLINE  finds  file  full 

The  keypad  editor  could  not  process 
the  OPENLINE  function  because  the 
output  file  i^  not  large  enough  for  a 
Carriage-Return/Linefeed  pair. 

OPENLINE  illegal  during  inspect 

When  you  are  inspecting  a  file,  the 
keypad  editor  cannot  complete  func- 
tions and  commands  that  would 
modify  the  file. 

PASTE  is  illegal  during  inspect 

When  you  are  inspecting  a  file,  the 
keypad  editor  cannot  complete  func- 
tions and  commands  that  would 
modify  the  file. 

Repeat: 

The  keypad  editor  displays  this  mes- 
sage when  you  press  the  GOLD  key  and 
then  type  a  digit  on  the  keyboard. 
Therefore,  the  message  appears  when 
you  use  the  sequence  to  repeat  a  func- 
tion and  when  you  use  the  SPECINS 
function  to  insert  a  character  that  you 
cannot  insert  directly. 

REPLACE  is  illegal  during  inspect 

When  you  are  inspecting  a  file,  the 
keypad  editor  cannot  complete  func- 
tions and  commands  that  would 
modify  the  file. 

Search  canceled 

The  keypad  editor  loads  this  message 
when  you  type  Prl^i  or  CmTZ,  to 
cancel     the     FIND     function     and 

Model  :  prompt. 


Refer  to  Section  A. 5  of  this  appendix  for 
suggestions  that  may  be  useful  when  your 
file  is  full. 


Use  any  valid  function  or  command. 


Use  any  valid  function  or  command. 


The  message  is  primarily  for  information, 
but  it  is  also  a  warning  that  the  special 
effects  of  repeated  functions  and  the 
SPECINS  function  are  enabled. 


Use  anv  valid  function  or  command. 


Use  any  valid  function  or  command. 
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Select  range  too  large  to  CUT 

The  keypad  editor  cannot  complete  a 
CUT  or  an  APPEND  function  because 
the  paste  buffer  is  too  small  for  all  of 
the  material  you  want  to  store  in  the 
buffer. 


TAB  Indent  value  wrong  for  align 

With  the  A  function,  the  column 
number  of  the  cursor's  position  is  not 
evenly  divisible  by  the  current  setting 
for  the  indentation. 

Tabs  not  enabled  for  ADJUST 

You  used  the  TABS  ADJUST  com- 
mand before  using  the  SET  TABS 
command. 

Target  not  found 

A  FIND  or  FINDNEXT  function 
moved  the  cursor  to  the  top  or  bottom 
of  the  file  without  finding  a  string  that 
matches  the  model  you  have  specified. 

Too  many  arguments  for  command 

The  keypad  editor  did  not  recognize  a 
command  because  you  added  extra 
characters  on  the  command  line  after 
the  last  valid  word  or  argument  in  the 
command. 

Unable  to  access  auxiliary  device 

See  "?KED-F-Unable  to  access  input 
device." 

Unable  to  close  auxiliary  file 

The  keypad  editor  could  not  close  the 
auxiliary  output  file.  The  output  de- 
vice may  have  caused  the  problem, 
and  the  keypad  editor  may  have  mal- 
functioned. 


Unable  to  delete  local  symbol  marker 
Unable  to  delete  target 
Unable  to  insert  tab 

1  he  keypad  editor  may  have  malfunc- 
tioned. 

Unable  to  open  auxiliary  input  file 

The  keypad  editor  could  not  open  the 
auxiliary  input  file  for  one  of  the  fol- 
lowing reasons. 

•  the  volume  does  not  contain  the  file. 

•  the  volume  has  not  been  initialized. 

•  the  device  is  not  ready. 


Process  the  selection  as  smaller  select 
ranges,  or  use  auxiliary  files  for  the  same 
purpose  as  the  CUT,  APPEND,  and 
PASTE  functions.  For  example,  write  the 
selection  temporarily  to  an  auxiliary 
output  file  and  close  it,  erase  the  selec- 
tion, move  the  cursor  to  where  you  want 
the  selection  to  be,  and  copy  the  material 
from  the  temporary  file  as  auxiliary  input 
file.  You  can  also  use  any  valid  function 
or  command. 

Check  that  the  cursor's  position  and  the 
indent  setting  are  both  correct.  To  align 
the  structured  tab  feature,  use  the  A 
function  again. 

Enable  structured  tabs  with  the  SET 
TABS  command  before  using  the  TABS 
ADJUST  command. 

Use  any  valid  function  or  command. 


Use  any  valid  function  or  command. 


Check  that  the  output  device  is  on-lirre. 
Also  try  the  suggestions  that  are  listed  for 
the  message  "?KED-F-Unable  to  access 
input  device."  If  the  me.ssage  continues  to 
appear,  refer  to  the  procedure  in  Section 
A. 4  of  this  appendix. 


Refer  to  the  procedure  in  Secticm  A. 4  oi 
this  appendix. 

Check  the  file  specification.  If  it  is  cor- 
rect, check  that  the  correct  volume  is  in- 
stallc'l  and  that  the  auxiliary  input  de- 
vice is  on-line. 
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Unable  to  open  auxiliary  output  file 

The  keypad  editor  couki  not  open  the  Check  that  the  auxiliary  output  volume 

auxiliary  output  file  for  one  of  the  fol-  has  heen  initialized.  Also  check  that  the 

lowing  reasons:  auxiliary    input    device    is    on-line    and 

write-enabled. 

•  the  volume  has  not  been  initialized. 

•  the  device  is  not  ready. 

•  the  device  is  write-locked. 


Unable  to  replace  symbol 

The  keypad  editor  may  have  malfunc- 
tioned. 

Undelete  buffer  full 

The  keypad  editor  could  not  finish 
processing  a  DELUXE  or  a  DEL- 
WORD  function  for  one  of  the  fol- 
lowing reasons: 

•  DELLINE  would  have  erased  more 
than  132  characters,  the  capacity  of 
the  line  buffer. 


Refer  to  the  procedure  in  Section  A. 4  of 
this  appendix. 

To  erase  larger  strings  than  the  line  and 
word  buffers  can  hold,  use  repeated  DEL- 
LINE  or  DELWORD  functions  (and  ig- 
nore the  error  signal),  or  use  the  paste 
buffer  or  auxiliary  files.  You  can  also  use 
anv  valid  function  or  command. 


•  DELWORD  would  have  erased  more 
than  80  characters,  the  capacity  of 
the  word  buffer. 


Undeletes  are  illegal  during  inspect 

When  you  are  inspecting  a  file,  the 
keypad  editor  cannot  complete  func- 
tions and  commands  that  would 
modify  the  file. 

Valid  start  of  LSB  not  found 

No  global  symbol  or  .ENABL  LSB  di- 
rective exists  between  the  cursor's  po- 
sition and  the  preceding  Formfeed 
character  or  the  top  of  the  file. 

WORKING.  .  . 

When  a  process  takes  longer  than 
normal,  the  keypad  editor  Hashes  this 
message  at  the  top  of  the  terminal 
screen  until  the  process  is  complete. 
Several  interrelated  factors,  such  as 
the  length  of  the  file  you  are  editing, 
the  devices  you  are  using,  and  the 
functions  you  are  using,  determine 
when  the  WORK  I NG  .  .  .  message  ap- 
pears. 

WRITE  finds  end  of  file 

Your  last  WRITE  command  copied 
the  last  character  of  your  main  file  to 
the  auxiliary  output  file. 


I'se  any  valid  functicm  or  command. 


Check  that  the  cursor  is  located  in  the 
first  page  of  an  LSB  before  you  use  the 
LOCAL  command. 


The  message  is  for  information  only. 


Cse  another  command  or  function. 
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Index 


A  function,  5-27 
Adjusting  structured  tabs,  5-28 
ADVANCE  function,  3-13 
Advance  mode,  3-13 
Aligning  structured  tabs,  5-27 
Allocating  output  file  space, 

IAS,  2-28 

RSX-11,  2-17 

RT-11,  2-9 
Alternate  functions  using,  3-1 
APPEND  function,  4-20 
Autorepeat  feature,  3-28 
Auxiliary  files, 

creating,  5-5  to  5-7 

input,  5-7  to  5-9 

opening,  5-7 

output,  5-5  to  5-7 

specifying,  5-4 

using  commands  for,  5-4  to  5-9 


B 


BACKUP  function,  3-13 
Backup  mode,  3-13 
Bell  signals,  3-2 
BLINE  function,  3-17 
BOTTOM  function,  3-19 
Buffers, 

character,  4-6 

line,  4-12 

macro,  5-19 

paste,  4-16  to  4-21 

sizes  and  uses,  4-5 

word,  4-9 


Canceling, 
an  editing  process,  3-7 
repeated  functions,  3-29 


Canceling  (Cont.), 
select  ranges,  3-2 
the  GOLD  function,  3-2 
Capitalizing  text,  4-24 
Carriage  Return-Linefeed  pair,  as  a  line 

terminator,  1-15 
Changing, 
direction  of  cursor  movement,  3-13 
help  signals,  3-4 
page  definition,  3-20  to  3-21 
search  limits,  3-25 
search  methods,  3-23  to  3-28 
section  definition,  3-20  to  3-21 
strings  —  see  SUBSTITUTE  function 
CHAR  function,  3-15 
Character  buffer,  4-6 
CHNGCASE  function,  4-24 
CLEAR  PASTE  command,  4-17 
CLOSE  command,  5-6 
Closing  files,  2-31,  5-6 
Combining  files,  5-7  to  5-9 
COMMAND  function,  1-8,  2-ra 
Command  lines  —  see  Comrr mtis,  IAS,  RT-11,  and 

RSX-11 
Command  qualifiers  —  jee  Options 
Command  String  Interpreter, 
file  specifications, 
/c  option,  2-7 
/i  option,  2-7 
for  creating  files,  2-7 
for  editing  files,  2-6 
for  inspecting  files,  2-7 
Command  switches  —  see  Options 
Commands, 
CLEAR  PASTE,  4-17 
CLOSE,  5-6 

compared  with  functions,  1-3  to  1-9 
definition  for  editing,  1-3 
EXIT,  2-21 
FILL,  5-14 

for  auxiliary  files,  5-4  to  5-9 
for  VTlOO  terminals,  3-4  to  3-6 
general  procedure  for  using,  1-8 


February  1981 
Index- 1 


Commands  (Cont.), 

INCLUDE,  5-8 

LEARN,  5-18 

LOCAL,  5-24 

OPEN  INPUT.  5-7 

OPEN  OUTPUT,  5-5 

PURGE,  5-7 

QUIT,  2-31 

SET  ENTITY  PAGE,  3-20 

SET  ENTITY  SECTION,  3-21 

SET  NOQUIET,  3-5 

SET  NOTABS,  5-27 

SET  NOWRAP,  5-14 

SET  QUIET,  3-4 

SET  SCREEN  132,  3-6 

SET  SCREEN  8C,  3-5 

SET  SCREEN  DARK,  3-6 

SET  SCREEN  LIGHT,  3-6 

SET  SEARCH  BEGIN,  3-24 

SET  SEARCH  BOUNDED,  3-25 

SET  SEARCH  END,  3-24 

SET  SEARCH  EXACT.  3-24 

SET  SEARCH  GENERAL,  3-24 

SET  SEARCH  UNBOUNDED,  3-25 

SET  TABS,  5-26 

SET  WRAP,  5-12 

SKIP,  5-8 

starting  up  under  IAS,  2-22 

starting  up  under  RSX-11  systems,  2-13  to  2-16 

starting  up  under  RT-U  systems,  2-2  to  2-8 

TABS  ADJUST,  5-28 

terminating,  3-6 

WRITE.  5-6 
Control  keys, 

CTRL/C,  3-7 

CTRLAJ.  4-13 

CTRL/W,  3-7 

CTRL/Z,  3-29 
Converting  characters.  4-24 
Copying, 

auxiliary  input  files,  5-8 

functions  for,  4-16  to  4-21 

text,  4-16  to  4-21 

to  and  from  auxiliary  files,  5-6 
Correcting. 

accidental  erasures.  4-4  to  4-15 

insertions  —  see  Erase  functions 

typing  errors.  4-7 
Creating  files. 

for  auxiliary  output.  5-5  to  5-7 

functions  for,  4- 1  to  4-24 

general  procedures,  1-12 

IAS  file  specifications.  2-24 

RSX-ll  file  specifications  for,  2-14 

RT-U  file  specifications  for.  2-7 

with  RT-11.  2-5 
CSI  —  see  Command  String  Interpreter 
CTRL/C  function.  3-7.  3-29 
CTRL/U  function,  4-13 
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CTRLAV  function.  3-7 

CTRL/Z  function,  3-29 

Cursor, 
definition  and  symbols,  1-10 
VTIOO  symbols  available,  2-2 

Cursor  movement  functions,  3-8  to  3-28 

CUT  function,  4-18 


D  function,  5-28 

Decreasing  structured  tab  indentation,  5-28 

Defaults, 

definition  of  page,  3-22 

definition  of  section,  3-23 

IAS,  2-21 

inserting  text,  4-2 

message  signal,  3-5 

page  definition,  1-16,  3-20 

right  margin  settings.  5-14 

RSX-11.  2-12 

RT-11  EDIT.  R.  and  RUN  commands.  2-3 

screen  background.  3-6 

screen  line  length,  3-5 

search  methods,  3-24  to  3-25 

section  definition,  1-17,  3-20 
Definitions, 

characters,  3-14 

commands,  1-3 

default  for  page,  3-22 

default  for  section,  3-23 

editor  macros,  5-17 

functions.  1-3 

line  terminators,  1-15 

new  Line,  1-15 

page,  1-16,  3-20 

purge.  2-31 

section.  1-17,  3-20 

select  ranges,  4-16 

target,  1-16 

text  line,  1-16 

word.  1-15.  3-14 

word-wrap,  5-12 

wrapped  line,  1-16 
DELCHAR  function.  4-6 
DELEOL  function.  4-14 
DELETE  function.  4-7 
Delete  key,  uses  for.  4-7 
Deleting, 

auxiliary  output  files.  5-7 

charp-'.ers.  4-6  to  4-7 

large  sections  of  text,  4-22 

lines.  4-12  to  4-14 

text,  4-4  to  4-15 

words,  4-9  to  4-10 
DELLINE  function,  4-12 
DELWORD  function,  4-9 


Diagrams, 

K52  keypad,  1-5 

KED  keypad,  1-4 
Directional  modes,  3-13 
Disabling  structured  tabs,  5-27 
Display  size  for  VTIOO  models,  1-9 
Downarrow  function,  3-10 


E  function,  5-28 

EDIT  commands,  RT-11,  2-3  to  2-5 
Editing  files, 
functions  for.  4-1  to  4-24 
general  procedures,  1-12 
IAS  con:mand  lines  for,  2-22 
RSX-11  command  lines  for.  2-13  to  2-14 
HT-ll  file  specifications  for.  2-5.  2-6,  2-8 
Enabling  structured  tabs,  5-26 
ENTER  function.  1-8.  2-31.  3-6 
EOL  function,  3-18 
Erasing, 
auxiliary  output  files.  5-7 
characters.  4-6  to  4-7 
functions  for.  4-4  to  4-15 
large  sections  of  text.  4-22 
lines,  4-12  to  4-14 
text,  4-4  to  4-15 
words,  4-9  to  4-10 
Error  messages,  A-1  to  A-14 
Escape  character,  inserting.  4-3 
Exact  searching,  3-24 
Examples, 
copying  a  selection.  4-20.  5-9  to  5-11 
cutting  a  selection.  4-19 
erasing  a  text  line.  4-12  to  4-14 
erasing  a  word,  4-9  to  4-10 
erasing  single  characters,  4-6  to  4-7 
inserting  blank  lines.  4-3 
inserting  by  ASCII  code,  4-3 
inserting  text  with  word-wrap,  5-13 
macro  to  change  word  target,  5-22 
macro  to  extract  material,  5-21 
macro  to  reformat  paragraphs,  5-23 
macro  to  shorten  a  program,  5-21 
macro  to  shorten  text  lines,  5-23 
moving  character-by-character,  3-15 
moving  line-by-line,  3-17  to  3-18 
moving  material  with  auxiliar'  files,  5-9 
moving  page-by-page,  3-22 
moving  word-by-word,  3-16 
re-ordering  several  lines.  4-20 
reformatting  selections,  5-15  to  5-16 
removing  several  lines,  4-19 
repeating  functions,  3-28 
repeating  the  PASTE  function,  4-4 
restoring  an  erased  character,  4-8 
restoring  an  erased  text  line,  4-15 


Examples  (Cont.). 

restoring  an  erased  word.  4-11 

sample. ked.  1-14  to  1-21 

searching,  3-26  to  3-28 

select  ranges,  4-19 

starting  the  editor  with  IAS,  2-22 

starting  the  editor  with  RSX-11,  2-13  to  2-16 

starting  the  editor  with  RT-11.  2-2  to  2-10 

wrap  symbol.  5-13 
Executing  macros.  5-20 
EXIT  command.  2-31 
Extending  structured  tab  indentation.  5-28 


File  protection. 
IAS.  2-26 
RSX-11.  2-15 
RT-11.  2-8 
File  size. 

IAS,  2-27,  2-29 

RSX-11,  2-16 

RT-11.  2-5.  2-9 
FILL  command.  5-14 
FILL  function,  5-14 
FIND  function,  3-13.  3-26 
FINDNEXT  function.  3-28 
Formfeed  character. 

as  a  line  terminator.  1-15 

inserting.  4-2 
Full  duplex  terminal  driver  requirements,  2-10 
Functions. 

A.  5-27 

ADVANCE.  3-13 

alternate,  using.  1-8 

APPEND.  4-20 

BACKUP.  3-13 

BLINE,  3-17 

BOTTOM.  3-19 

CHAR,  3-15 

CHNGCASE,  4-24 

COMMAND,  1-8.  2-30 

compared  with  commands,  1-3  to  1-9 

CTRL/C.  3-7,  3-29 

CTRL/U.  4-13 

CTRLAV,  3-7 

CTRiyZ,  3-29 

CUT,  4-18 

D.  5-28 

definition  for  editing,  1-3 
DELCHAR,  4-6 
DELEOL,  4-14 
DELETE,  4-7 
DELLINE.  4-12 
DELWORD,  4-9 
Downarrow,  3-10 

E,  5-28 

ENTER,  1-8,  2-31,  3-6 
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Functions  (Cont.), 
EOL,  3-18 
FILL,  5-14 
FIND,  .S-13.  3-26 
FINDNEXT,  3-28 
for  substitutions,  4-21  to  4-24 
general  procedure  for  using,  1-7 
GOLD,  1-8,  3-1 
HELP,  3-2 
keyboard,  5-19,  5-27 
Leftarrow,  3-11 
LINEFEED,  4-10 
OPENLINE,  4-3 
PAGE,  3-22 
PASTE,  4-20 
REPLACE,  4-11,  4-22 
RESET,  3-2 
Rightarrow,  3-9 
S,  5-19 

SECTION,  3-23 
SELECT,  4-17 
SPECINS,  4-3 
standard,  using,  1-7 
SUBSTITUTE,  4-11,  4-23 
to  copy  text,  4-16  to  4-21 
to  erase  text,  4-4  to  4-15 
to  inspect  files,  3-1  to  3-29 
to  move  text,  4-16  to  4-21 
to  move  cursor,  3-8  to  3-28 
to  repeat  functions,  3-28 
to  restore  erasures,  4-4  to  4-15 
to  search,  3-26  to  3-28 
to  use  editor  commands,  2-30 
TOP,  3-19 
UNDELCHAR,  4-8 
UNDELLINE,  4-15 
UNDELWORD,  4-11 
uparrow,  3-12 
WORD,  3-16 
X,  5-20 

Q 

General  searching,  3-24 

GOLD  function,  1-8,  3-1 

GOLD  functions  —  see  Alternate  functions 


Horizontal  Tab,  as  a  word,  1-15 

Hung  terminals  with  RT-11  systems,  2-10 


I 


IAS  systems, 

auxiliary  file  specifications  for,  5-4 

command  lines, 
creating  files,  2-24 
editing  files,  2-25 
inspecting  files,  2-24 
options,  2-22 

file  protection,  2-26 

file  size,  2-27,  2-29 

input  buffer  size,  2-29 

paste  buffer  size,  2-30 

restrictions  for  editing,  2-26 

starting  the  editor  with,  2-22 

stopping  the  editor,  2-30  to  2-32 

use  of  version  numbers,  2-25 
INCLUDE  commands,  5-8 
Increasing  buffer  size, 

IAS,  2-30 

RSX-11,  2-19 
Input  buffer  size, 

IAS,  2-30 

RSX-11,  2-19 
INPUT  command,  5-7 
Input  files,  record  length  with  RSX-11,  2-19 
Inserting, 

blank  lines,  4-3 

characters  by  ASCII  code,  4-3 

escape  characters,  4-3 

line  terminators,  4-2 

material  in  a  file,  1-7 

repeating  insertions,  4-4 

text,  4-1  to  4-4 
Inspecting  files, 

functions  for,  3-1  to  3-29 

general  procedures,  1-11 

IAS  command  lines  for,  2-23,  2-24 

RSX-11  command  lines  for,  2-14 

RT-11  file  specifications  for,  2-7 

with  RT-11,  2-5 


H 


Help, 

signaling  messages,  3-4 

signals  for,  3-2 
HELP  displays, 

removing,  3-6 
HELP  function,  3-2 
Horizontal  Tab, 

displaying,  3-10 
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KED  and  K52  compared,  1-2 


Learn  command,  5-18 
Leftarrow  function,  3-11 
Limiting  searching,  3-25 
Line  buffer,  4-12 


Line  terminators, 

definition,  1-15 

erasing,  4-6 

inserting,  4-2 
Linefeed  character, 

as  a  line  terminator,  1-16 

displaying,  3-10 

inserting,  4-2 
LINEFEED  function,  4-10 
LOCAL  command,  5-24 
Local  symbols, 

reordering,  5-24  to  5-25 
Locating  characters  —  .see  Searching 
Locked  files, 

IAS,  2-27 

RSX-11,  2-17 
LSBS  —  see  Local  symbols 


M 


MACRO- 11  local  symbols,  features  for,  5-24 

to  5-25 
Macros, 

buffer  capacity,  5-19 

definition,  5-17 

example  of  extracting  material,  5-21 

example  of  reformatting  paragraphs,  5-23 

example  of  shortening  a  program,  5-21 

example  of  shortening  text  lines,  5-23 

example  of  substitute  word  target,  5-22 

examples,  5-20  to  5-24 

executing,  5-20 

recording,  5-18 

size,  5-18 

terminating,  5-19 

using,  5-17  to  5-24 
Messages, 

complete  listing.  A- 1  to  A-14 

display  method  for,  1-10 

help,  3-4 

"WORKING...",  3-19,  3-28 
Modes, 

advance,  3-13 

backup,  3-13 
Moving, 

character-by-character,  3-15 

line-by-line,  3-17 

page-by-page,  3-22 

section-by-section,  3-23 

text  selections,  4-16  to  4-21 

to  the  beginning  of  file,  3-19 

to  the  beginning  of  line,  3-17 

to  the  end  of  file,  3-19 

to  the  end  of  line,  .3-18 

word-by-word,  3-16 


N 


New  Line, 

definition,  1-15 

documentation  symbol  for,  1-15 

inserting,  4-2 
Non-privileged  users, 

IAS,  2-26 

RSX-11,  2-15 


OPEN  INPUT  command,  5-7 

OPEN  OUTPUT  command,  5-5 

Opening  auxiliary  input  files,  5-7 

OPENLINE  function,  4-3 

Options, 
RSX-11  command  lines,  2-13  to  2-14 
RT-1 1  EDIT  command,  2-4  to  2-5 

OUTPUT  command,  5-5 

Output  files, 
allocating  space  with  IAS,  2-27 
allocating  space  with  RSX-11,  2-17 
closing,  2-31 

record  length  with  IAS,  2-29 
record  length  with  RSX-11,  2-18 


PAGE  function,  3-22 
Pages, 

changing  the  definition,  3-20  to  3-21 

definition,  1-16 

suggested  uses,  3-25 

uses  for,  5-6 
Paste  buffer, 

clearing,  4-17 

size,  2-19,  4-17 
PASTE  function,  4-20 

alternative  to,  5-9 

repeating,  4-4 
Pointer  —  .see  Cursor 
Private  devices,  RSX-11,  2-15 
Privileged  users,  RSX-11,  2-15 
Prompts, 

Command:,  2-31 

CSI  level  (*),  2-3 

display  method  for,  1-10 

KED  and  K52  under  RSX-11,  2-12 

Model:,  3-26 

Repeat:,  3-29 

RSX-11  task  names,  2-12 

RT-11  monitor  level  (.),  2-2 
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Protection  of  files, 

IAS,  2-26 

RSX-11,  2-15 

RT-11,  2-8 
Public  devices, 

RSX-11,  2-15 
PURGE  command,  5-7 
Purge,  definition,  2-31 


Qualifiers  —  see  Options 
QUIT  command,  2-31 


R 


R  commands  (RT-11),  2-6  to  2-8 
Reading  auxiliary  input  files,  5-8 
Record  length, 

IAS  systems,  2-19 

RSX-11  systems,  2-19 
Reformatting, 

selections,  5-14 

source  listings,  5-25  to  5-32 
Repainting  the  screen,  3-6  to  3-7 
Repeat  key,  3-29 
Repeat:  prompt,  3-29 
Repeating, 

functions,  3-28 

insertions,  4-4 

searches,  3-28 

substitutions,  4-23 
REPLACE  function,  4-11,  4-22 
RESET  function,  3-2 
Restore  functions,  4-4  to  4-15 
Restoring, 

erased  characters,  4-8 

erased  lines,  4-15 

erased  words,  4-11 

text,  4-4  to  4-15 
Restrictions, 

non-repeatable  functions,  3-29 

RSX-11,  2-15 

RT-11,  2-8 
Return  key,  to  insert  line  terminators,  4-2 
Reverse  video  display,  1-10 
Reverse  video  signal,  3-2 
Right  margin, 

changing,  5-11  to  5-13 

setting,  5-11  to  5-13 
Rightarrow  function,  3-9 
RSX-11  systems, 

auxiliTy  file  specifications  for,  5-4 

command  lines, 
creating  files,  2-14 
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RSX-11  systems  (Cont.), 

editing  files,  2-13  to  2-14 
inspecting  files,  2-14 
options,  2-15 

file  protection,  2-15 

file  size,  2-16 

input  buffer  size,  2-19 

paste  buffer  size,  2-19 

restrictions  for  editing,  2-15 

starting  the  editor  with,  2-11  to  2-19 

stopping  the  editor,  2-30  to  2-31 

use  of  version  numbers,  2-13 
RSX-llM  systems, 

full  duplex  terminal  driver  requirements,  2-1 

settings  for  video  terminals,  2-1 

stopping  the  editor,  2-30  to  2-31 

terminal  driver  requirements,  2-10 

VTIOC  ANSI  mode  effects,  2-2 
RSX-llM  systems  —  see  RSX-11  systems 
RSX-llM-PLUS  systems, 

settings  for  video  terminals,  2-1 

starting  the  editor  with,  2-30 

stopping  the  editor,  2-30  to  2-31 

terminal  driver  requirements,  2-10 

VTlOO  ANSI  mode  effects,  2-2 
RSX-llM-PLUS  systems  —  see  RSX-11  systems 
RT-11  commands, 

R,  2-6 

RUN,  2-6 
RT-11  systems, 

auxiliary  file  specifications  for,  5-4 

EDIT  command  and  options,  2-3  to  2-5 

file  protection,  2-8 

file  size,  2-9 

indirect  command  files  for  editing,  2-4 

R  commands  for  editing,  2-6  to  2-8 

restrictions  for  editing,  2-8 

RUN  commands  for  editing,  2-6  to  2-8 

SET  commands  for  editing,  2-1,  2-4 

settings  for  video  terminals,  2-1 

starting  the  editor  with,  2-2  to  2-10 

stopping  the  editor,  2-30  to  2-31 

terminal  requirements,  2-10 
RUN  commands  (RSX-11),  2-13  to  2-16 
RUN  commands  (RT-11),  2-6  to  2-8 


S  function,  5-19 
SAMPLE.KED,  1-14  to  1  .1 
Screen  line, 
adjusting  length  on  VTlOOs,  3-5 
compared  with  text  line,  1-16 
Screen  size  for  VTlOO  models,  1-9 
Search  functions,  3-26  to  3-28 
Search  methods,  3-23  to  3-28 


Searching, 

limiting  to  a  page,  3-25 

relationship  to  PAGE  function,  3-21 

with  exact  matching,  3-24 

with  general  matching,  3-24 
Section, 

changing  the  definition,  3-20  to  3-21 

definition,  1-17 
SECTION  function,  3-23 
SELECT  function,  4-17 
Select  ranges, 

canceling,  3-2 

definition,  4-16 

displaying,  4-17 
SET  commands, 

KED,  3-4  to  3-6 

RT-11,  2-1 
SET  commands,  5-11  to  5-14 
SET  ENTITY  PAGE  command,  3-20 
SET  ENTITY  SECTION  command,  3-21 
SET  NOQUIET  command,  3-5 
SET  NOTABS  command,  5-27 
SET  NOWRAP  command,  5-14 
SET  QUIET  command,  3-4 
SET  SC7  EEN  132  command,  3-6 
SET  SCREEN  80  command,  3-5 
SET  SCREEN  DARK  command,  3-6 
SET  SCREEN  LIGHT  command,  3-6 
SET  SEARCH  BEGIN  command,  3-24 
SET  SEARCH  BOUNDED  command,  3-25 
SET  SEARCH  END  command,  3-24 
SET  SEARCH  EXACT  command,  3-24 
SET  SEARCH  GENERAL  command,  3-24 
SET  SEARCH  UNBOUNDED  command,  3-25 
SET  TABS  command,  5-26 
SET  WRAP  command,  5-12 
Setting, 

right  margin,  5-11  to  5-13 

search  limits,  3-25 

text  line  length.  5-11  to  5-13 

the  page  definition,  3-20  to  3-21 

the  screen  display,  3-6 

the  section  definition,  3-20  to  3-21 
Setting  KED's  message  signal,  3-4 
Signals  about  help,  3-2 
SKIP  commands,  5-8 
Skipping  auxiliary  input  material,  5-8 
Space  required  for  storage,  RSX-11,  2-16 
Specifying  auxiliary  files,  5-4 
SPECINS  function,  4-3 
Starting  the  editor,  1-1 

IAS  procedure,  2-2 

RSX-11  procedure,  2-11  to  2-19 

RSX-llM  procedure,  2-1 

RSX-llM-PLUS  procedure,  2-1 

RT-11  procedure,  2-2  to  2-10 
Stopping  editor  macros,  5-19 
Stopping  the  editor,  1-1,  2-30  to  2-31 


Storage  space  required, 

IAS,  2-27 

RSX-11,  2-16 
Structured  tabs, 

enabling,  5-26 

features  for,  5-25  to  5-32 
SUBSTITUTE  function,  4-11,  4-23 
Substitution  functions,  4-21  to  4-24 
Summaries, 

arrow  functions,  3-8 

buffer  capacities,  4-5 

commands  —  see  Commands 

creating  auxiliary  output  files,  5-6 

editor  capabilities,  1-2 

editor  commands,  1-6 

editor  macro  features,  5-17 

erase  functions,  4-5 

IAS  command  line  options,  2-22  to  2-30 

KED  commands  for  VTlOO  terminals,  3-4  to  3-5 

line  terminators,  1-15 

MACRO- 11  local  symbol  features,  5-24 

method  for  moving  large  sections,  5-9 

methods  of  formatting  text,  5-11 

move  and  copy  functions,  4-16 

PAGE  and  SECTION  usage,  3-20  to  3-23 

procedure  for  nonrecoverable  conditions,  A-2 

reducing  macro  size,  5-18 

restore  functions,  4-5 

RSX-11  command  line  options,  2-15 

RSX-11  start-up  defaults,  2-12 

RT-11  EDIT,  R,  and  RUN  command  defaults, 
2-3 

search  methods,  3-23  to  3-28 

structured  tab  features,  5-25 

substitution  functions,  4-21 

units  of  text  recognized,  3-14 

using  auxiliary  input  files,  5-7 

using  auxiliary  output  files,  5-5 

VTlOO  and  VT52  symbols,  1-10 
Switches  —  see  Options 
Switching  help  signals,  3-4 
Symbols, 

editor  documentation,  ix 

VTlOO  and  VT52,  summary,  1-10 

wrap,  1-16 


Tabs, 

structured,  5-25  to  5-32 
Tabs  —  see  Horizontal  Tab,  Vertical  Tab 
TABS  ADJUST  command,  5-28 
Target,  definition,  1-16 
Temporary  files, 

IAS,  2-27 

RSX-11,  2-16 
Terminal  driver,  requirements,  2-10 
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Terminal  requirements,  RT-U,  2-10 
Terminating, 

commands,  3-6 

macros,  5-19 
Text  line, 

compared  with  screen  line,  1-16 

definition,  1-16 
Text  lines  and  screen  lines, 

differences,  3-14 
TOP  function,  3-19 
Truncated  records, 

IAS,  2-29 

RSX-11,  2-19 

Typing  errors,  correcting,  4-7 

Typing  new  material,  4-2 


u 


UNDELCHAR  function,  4-8 
UNDELLINE  function,  4-15 
UNDELWORD  function,  4-11 
Underscoring,  use  by  KED,  1-10 
Unlocking  locked  files, 

IAS,  2-27 

RSX-11,  2-17 
Uparrow  function,  3-12 


Version  numbers, 

IAS,  2-25 

RSX-11,  2-13 
Vertical  Tab  character, 

as  a  line  terminator,  1-15 

inserting,  4-2 


Video  reverse  —  see  Reverse  video 

VTlOO  terminals, 
autorepeat  feature,  3-28  to  3-29 
cursor  symbols  available,  2-2 
editing  with  —  see  KED 
KED  commands  for,  3-4  to  3-6 
setting  characteristics,  2-2 
symbols  used  by  KED,  1-10 
using  different  models,  1-9 

VT52  terminals, 
editing  with  —  see  K52 
repeat  key,  3-29 
symbols  used  by  K52,  1-10 


w 

Word, 

definition,  1-15 
Word  buffer,  4-9 
WORD  function,  3-16 
Word,  definition,  3-14 
Word-wrap, 

definition,  5-12 

disabling,  5-14 

enabling,  5-13 
WORKING...  message,  3-19,  3-28 
Wrap  symbol,  1-16,  5-13 
Wrapped  line,  definition,  1-16 
WRITE  commands,  5-6 


X  function,  5-20 
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